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PREFACE 


MANUAL  OBJECTIVES 

The  RSX- 11 M/M- PLUS  System  Management  Guide  documents  system  programs 
and  procedures  that  test,  monitor,  maintain,  and  customize 
RSX-11M/M-PLUS  operating  systems  after  system  generation. 


INTENDED  AUDIENCE 


This  manual  is  intended  for  system  managers,  operators,  and  system 
programmers  who  perform  system  management  functions.  The  manual  is 
not  intended  for  general  users  or  applications  programmers. 


STRUCTURE  OF  THIS  MANUAL 


The  RSX- 11 M/M- PLUS  System  Management  Guide  consists  of  19  chapters  and 
two  appendixes  as  follows: 

Chapter  1  summarizes  each  program  and  procedure  described  in  Chapters 
2  through  19. 


Chapter  2  describes  how  you  use  the  Account  File  Maintenance  Program 
( ACNT )  to  create  and — maiTTEain  accounts  on  multiuser  protection 
systems . 


Chapter  3  describes  how  you  use  the  Console  Logger  to  control  I/O 
the  console  output  device  (CO):  and  record  system  messages  a 

terminal  and/or  in  a  log  file. 


to 
t  a 


Chapter  4  describes  how  you  use  the  I/O  Exerciser  (IOX)  to  detect  and 
diagnose  I/O  problems  on  the  disk,  terminal,  and  tape  units  in  your 
system’s  hardware  configuration. 


Chapter  5  describes  how  the  Bad  Block  Replacement  Control  Task  (RCT ) 
performs  bad  block  handling  and  recovery  on  Mass  Storage  Control 
Protocol  (MSCP)  devices  such  as  the  RA80. 

Chapter  6  describes  how  you  use  the  Resource  Monitoring  Display  (RMD) 
to  display  information  about  the  active  tasks  in  your  operating  system 
and  the  availability  of  system  resources. 


Chapter  7  describes  how  to  set  up  the  Queue  Manager  for  convenient 
multistream  line-printer  spooling. 

For  RSX- 1 1M -PLUS  systems  only,  this  chapter  describes  how  you  set  up 
batch  processors  that  enable  you  to  direct  a  command  sequence  to  the 
operating  system  at  a  predetermined  time  of  day. 
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Chapter  8  describes  how  you  use  the  SHUTUP  Program  to  shut  down  the 
system  in  an  orderly  fashion. 

Chapter  9  describes  how  you  use  the  Data  Terminal  Emulator  (DTE)  to 
log  in  from  a  local  Micro/RSX  system  to  an  external  computer  system 
and  conduct  an  interactive  session. 

Chapter  10  describes  how  you  use  the  Virtual  Monitor  Console  Routine 
(VMR)  to  alter  a  system  image  file  on  disk. 

Chapter  11  describes  command  line  interpreter  tasks,  including  how  to 
write  them  and  how  to  use  new  Executive  directives  in  them. 

Chapter  12  describes  how  to  task  build  and  install  the  DCL  task  with 
various  options.  It  also  describes  the  Macro  Meta  language,  which  is 
a  set  of  macros  that  describes  the  mapping  from  DCL  syntax  to  MCR 
syntax.  With  this  language,  you  can  alter  or  add  commands  to  extend 
DCL. 

Chapter  13  describes  the  Pool  Monitoring  Support  that  controls  the  use 
of  the  system’s  dynamic  storage  region  (pool). 

Chapter  14  describes  the  Shuffler,  which  is  a  task  that  compacts 
memory  space  in  system-controlled  partitions. 

Chapter  15  describes  how  you  use  the  RSX-11M-PLUS  reconfiguration 
services  (CON  and  HRC)  to  reconfigure  system  resources  to  isolate  the 
system  from  the  effects  of  faulty  hardware  elements. 

Chapter  16  describes  RSX-11M-PLUS  I/O  Queue  Optimization,  which 
improves  the  throughput  of  the  disk  subsystems  used  in  your  system. 

Chapter  17  describes  RSX-11M-PLUS  Resource  Accounting,  which  creates  a 
transaction  file  of  system  usage  information. 

Chapter  18  describes  RSX-11M-PLUS  Shadow  Recording,  which  allows  your 
system  to  back  up  all  information  being  written  to  a  Files-11  disk. 

Chapter  19  describes  RSX-11M-PLUS  and  Micro/RSX  Disk  Data  Caching,  a 
feature  that  enhances  I/O  operations  by  reducing  the  number  of 
physical  I/O  requests  performed  during  a  disk  operation. 

Appendix  A  describes  the  Serial  Despooler,  which  is  superseded  by  the 
Queue  Manager  to  handle  line-printer  spooling  for  most  systems. 

Appendix  B  describes  the  set  of  User  File  Directory  (UFD)  conventions 
observed  by  the  operating  system  for  files  on  disk.  A  section  of  file 
naming  conventions  is  also  included. 


ASSOCIATED  MANUALS 

Before  you  read  this  manual,  you  should  be  familiar  with  the 
RSX-11M/M-PLUS  MCR  Operations  Manual,  the  RSX-11M/M-PLUS  Utilities 
Manual ,  and,  for  DIGITAL  Command  Language  users,  the  RSX-11M  Command 
Language  Manual  or  RSX-11M-PLUS  Command  Language  Manual^  Although  you 
do  not  need  to  read  the  RSX-11M  System  Generation  and  Installation 
Guide  or  the  RSX-11M-PLUS  System  Generation  and  Installation  Guide 
before  reading  this  manual,  system  generation  logically  precedes  your 
use  of  the  programs  and  procedures  documented  in  this  manual. 
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CONVENTIONS  USED 

IN  THIS  MANUAL 

Convention 

Meaning 

red  ink 

Designates  user  input.  Responses  from 

programs  are  designated  in  black  ink. 

blue  ink 

Designates  RSX-11M-PLUS  multiprocessor  system 
information . 

•  •  • 

• 

A  horizontal  ellipsis  indicates  that  the 
command  line  element  immediately  preceding 
the  ellipsis  can  be  repeated  one  or  more 
times . 

A  vertical  ellipsis  indicates  that  part  of  a 
command  sequence  or  program  output  continues 
but  is  not  relevant  to  the  discussion  of  the 
example . 

lowercase 

In  a  command  line,  lowercase  words  and 
letters  indicate  that  you  substitute  a  value. 
Usually,  the  lowercase  word  describes  the 
value  to  be  substituted. 

UPPERCASE 

Command  elements  other  than  those  shown  in 
lowercase  for  which  you  substitute  a  value 
are  always  uppercase.  Within  descriptions, 
these  command  elements  are  never  truncated. 
In  examples,  they  may  be  truncated  according 
to  the  rules  of  the  particular  program. 

O 

A  reverse  number  is  a  white  number  printed  in 
a  black  circle.  These  numbers  key  a  part  of 
an  example  to  the  text  that  explains  that 
part  of  the  example.  The  reverse  number 
appears  both  in  the  example  and  the 
explanation. 

[optional] 

Square  brackets  indicate  that  the  enclosed 
item  is  optional. 

shading 

Shaded  portions  of  text  describe  only  one 
operating  system. 

Gray  shading  indicates  that  the  text  applies 
only  to  RSX-1 1M-PLUS  operating  systems. 
Shading  is  not  used  in  chapters  that  describe 
programs  that  are  unique  to  RSX-11M-PLUS . 

Red  shading  indicates  that  the  text  applies 
only  to  RSX-11M  operating  systems. 

Portions  of  text  that  are  not  shaded  describe 
both  operating  systems,  except  in  the 
RSX-llM-PLUS-only  chapters. 

fCTRL/a) 

The  symbol  (STOP  indicates  that  you  press  a 
key  while  simultaneously  pressing  and  holding 
down  the  CTRL  key;  for  example,  CTRL/C, 
CTRL/O. 
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SUMMARY  OF  TECHNICAL  CHANGES 


The  programs  and  procedures  described  in  this  manual  have  all  been 
enhanced  to  include  new  software  features.  The  following  lists 
descriptions  of  new  software  and  the  enhancements  to  previously 
existing  software  for  RSX-11M  Version  4.2  and  RSX-llM-PLUS  Version 

3.0. 


I/O  Exerciser  (IOX) 

Support  for  exercising  terminals  has  been  added.  This  is  accomplished 
by  using  the  LOOPBACK  parameter  to  the  SELECT  command. 


Account  File  Maintenance  Program  (ACNT) 

On  RSX-llM-PLUS  systems,  passwords  are  now  automatically  encrypted 
when  they  are  created.  Passwords  can  now  be  up  to  39  characters  long. 


Resource  Monitoring  Display  (RMD) 

Two  new  displays  about  cache  regions  have  been  added:  the  RMD  C  page, 
which  displays  general  statistics  about  a  cache  region;  and  the  RMD  D 
page,  which  displays  detailed  statistics  about  a  cached  device. 
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Virtual  Monitor  Console  Routine  (VMR) 

The  VMR  chapter  includes  the  following  changes: 

•  New  Introduction. 


SHUTUP  Program 

Messages  now  include  a  "reason  for  shutdown"  field  on  RSX-llM-PLUS 
systems . 


•  New  Table  of  Commands. 

•  Revised  section  describing  how  to  start  VMR. 

•  Additional  information  about  the  FIX-IN-MEMORY  command  which 
describes  fixing  tasks  on  RSX-11S  systems  with  memory 
management  (PLAS)  support.  Also,  information  has  been  added 
which  describes  fixing  tasks  on  RSX-11M  and  RSX-11S  systems 
above  124K-words. 
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•  Information  has  been  added  to  the  NOTES  section  of  the  INSTALL 
command  which  describes  (on  RSX-11M  and  RSX-11M-PLUS  systems) 
what  happens  to  changes  made  in  a  common  when  a  common  is 
removed  and  then  reinstalled.  New  information  has  also  been 
added  which  describes  restrictions  for  using  the  INSTALL 
command  to  install  device  commons  that  were  created  with  the 
SET/PAR  command . 

New  INSTALL  command  examples  have  been  added. 

•  A  NOTE  has  been  added  to  the  LOAD  command  indicating  that  you 
can  load  drivers  above  the  124K-word  limit  on  RSX-11M  systems. 

•  More  information  and  new  restrictions  have  been  added  to  the 
REDIRECT  command ,  which  describes  redirecting  I/O  requests 
from  one  physical  device  to  another. 

•  New  NOTES  have  been  added  to  the  REMOVE  command  describing  (on 
RSX-11M  and  RSX-11M-PLUS  systems)  what  happens  to  changes  made 
in  a  common  when  a  common  is  removed  and  then  reinstalled. 
Also  ,  another  new  NOTE  has  been  added  which  indicates  (on 
RSX-11M-PLUS  systems)  that  a  region  cannot  be  removed  if  there 
are  tasks  installed  in  the  system  that  reference  that  region. 

•  The  description  of  the  RUN  command  has  been  totally  revised. 
New  RUN  command  examples  have  been  added. 

•  The  SAVE  command  supports  the  following  new  devices: 

DU: 

MU: 

Also,  a  NOTE  to  the  SAVE  command  has  more  information  about 
saving  a  system  on  paper  tape. 

•  New  SET  command  examples  have  been  added. 


New  VMR  Keywords 


The  following  VMR  commands  have  new  keywords: 


ASSIGN 

/SYSTEM 

(RSX-11M-PLUS  systems  only.) 
Defines,  displays  or  deletes 
system-wide  logical  device 
assignments . 

INSTALL 

/WB 

(RSX-11M-PLUS  systems  only.) 
Specifies  where  a  read/write 
common  will  be  checkpointed  to. 

/FMAP 

(RSX-1 1M-PLUS  systems  only.) 
Informs  the  system  that  the  task 
will  use  the  fast-mapping 
feature  of  the  Executive. 
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SET 


/AVO 

/BLKMOD 

/DEC 

/EDIT 

/HSYNC 

/PARITY 

/PASTHRU 

/PRINTER_PORT 

/REGIS 

/SOFT [=ttnn : ] 

/TTSYNC 


(Full-duplex  terminal  driver 
only.)  Informs  the  system  that 
the  specified  VTlOO-series 
terminal  has  the  advanced  video 
option. 

(Full-duplex  terminal  driver 
only.)  Enables  local  editing  and 
block-mode  transmission  for  the 
specified  terminal . 

(Full-duplex  terminal  driver 
only.)  Indicates  that  the 
specified  terminal  is  upwardly 
compatible  with  the  VTlOO-series 
of  terminals. 

(Full-duplex  terminal  driver 
only.)  Informs  the  system  that 
the  specified  terminal  can 
perform  ANSI-defined  advanced 
editing  functions. 

(Full-duplex  terminal  driver 
only. ) Enables  host- terminal 
synchronization,  which  controls 
the  typeahead  buffer  to  prevent 
it  from  overflowing. 

Enables  parity  generation  and 
checking . 

(Full-duplex  terminal  driver 
only.)  Instructs  the  system  to 
ignore  the  original  function  of 
special  characters  typed  at  the 
specified  terminal  and  to 
instead  pass  them  to  a  program 
in  their  binary  form. 

(Full-duplex  terminal  driver 
only.)  Informs  the  system  that 
the  specified  terminal  has  a 
printer  port. 

(Full-duplex  terminal  driver 
only.)  Informs  the  system  that 
the  specified  terminal  supports 
the  ReGIS  graphics  set. 

(Full-duplex  terminal  driver 
only.)  Informs  the  system  that 
the  specified  terminal  can 
accept  software-defined 
character  sets. 

(Full-duplex  terminal  driver 
only.)  Enables  the  terminal 
synchronization  option  for  the 
specified  terminal. 
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Modified  VMR  Keywords 

The  following  VMR  command  keywords  have  new  information 


INSTALL 

/CL  I 

Indicates  that  the  task  being  installed  is  a  Command  Line 
Interpreter  (CLI) . 

/XHR 

Use  the  /XHR  keyword  when  installing  tasks  with  external  headers. 


SET 


/BUF 

The  buffer  size  for  a  terminal  must  be  greater  than  or  equal  to 
14 (decimal) . 

/POOLS I ZE 

If  you  do  not  specify  a  value  (on  RSX-11M-PLUS  systems) ,  VMR  also 
displays  the  lowest  physical  address  at  which  a  partition  can 
start  (32-word  blocks)  . 

/REMOTE 

The  terminal  has  a  line  to  the  following  additional  multiplexers: 

DHU11 

DHVll 

DLVll 

DZQ11 

DZV11 

You  can  specify  several  different  answer  speeds  for  the  following 
variable-speed  multiplexers: 

DHUll 

DHVll 

DZQ11 

DZVll 

You  cannot  specify  an  answer  speed  for  a  DL11  or  DLVll 
multiplexer. 


/SPEED 

You  can  specify  additional  speeds  for  the  following  multiplexers: 

DHll 

DHUll 

DHVll 

DZ 11 

DZVll 

DZQ11 

If  you  have  a  DZ11,  DZQll,  or  DZVll  multiplexer,  the  receive  and 
transmit  speeds  must  be  the  same  because  these  multiplexers  do 
not  support  split  speeds. 


xix 


SUMMARY  OF  TECHNICAL  CHANGES 


/TERM 


The  SET/TERM  command  supports  the  following  additional 
types : 


terminal 


DTC01 

LN03 

PC3XX 


LA50  LQP02 
LA210  LQP03 
VT2XX 


New  VMR  Error  Messages 

VMR  has  new  error  messages  that  pertain  to  bus  switches,  shared 
regions,  LOAD/CTB  keyword,  fast  mapping,  and  pool  space. 


Disk  Data  Caching 

RSX-11M-PLUS  and  Micro/RSX  now  include  support  for  disk  data  caching. 
Disk  data  caching  enhances  I/O  operation  by  reducing  the  number  of 
physical  I/O  requests  performed  during  a  disk  operation. 
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CHAPTER  1 


INTRODUCTION 


This  chapter  summarizes  the  functions  of  the  programs  and  procedures 
documented  in  the  chapters  of  this  manual.  Each  chapter  is  summarized 
in  the  order  in  which  it  is  presented  in  the  manual. 


Chapter  2  -  Account  File  Maintenance  Program  (ACNT) 

The  Account  File  Maintenance  Program  (ACNT)  allows  a  privileged  user 
to  create  and  maintain  an  account  file  on  multiuser  protection 
systems.  Each  account  entry  consists  of  information 
account  number  (the  user 1 s  UIC)  and  password, 

(SY:),  the  user's  first  and  last  name,  and  tt 

language  interpreter  (CLI).  ACNT  allows  a  privileged  user  to  create 
an  account  file,  add  and  delete  accounts,  modify  accounts,  list 
accounts,  examine  an  individual  account,  and  sort  the  account  entries. 


such  as  an 

the  default  device 
the  default  command 

jed  user  to  ere 

the 


The  chapter  describes,  with  examples,  how  to  use  each  ACNT  function. 


Chapter  3  -  Console  Logger 

The  Console  Logger  consists  of  a  driver  (CODRV)  and  a  task  (COT...) 
that  handle  I/O  to  the  console  output  device  (CO:)  and  record 
time-stamped  system  messages  on  a  terminal  and/or  in  a  log  file.  You 
use  MCR  SET  commands  from  a  privileged  terminal  to  start  and  stop 
console  logging,  disable  the  log  file  or  the  console  terminal,  and 
reassign  the  log  file  and  console  terminal.  You  select  Console  Logger 
support  during  SYSGEN. 

The  chapter  documents  the  console  logging  commands  and  presents  an 
extensive  terminal  session  with  explanations  of  the  commands  used  in 
the  session. 


Chapter  4  -  I/O  Exerciser  (IOX) 

The  I/O  Exerciser  (IOX)  detects  and  diagnoses  I/O  problems  on  the 
disk,  tape,  and  terminal  units  in  your  system's  hardware 
configuration.  IOX  exercises  Files-11  disks,  non-file-structured 
disks,  magnetic  tapes,  DECtapes,  and  cassettes.  IOX  performs  three 
kinds  of  exercises.  The  IOX  Command  Language  enables  you  to  specify 
and  control  the  exercise  for  the  units  in  your  system.  You  choose  an 
exercise  appropriate  to  a  unit  and  set  exercise  parameters  that 
determine  how  the  unit  is  exercised. 

The  chapter  documents  each  IOX  command  in  alphabetical  order  and 
provides  examples  that  explain  how  tox  set  parameters  for  the  three 
kinds  of  IOX  exercises. 
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Chapter  5  -  Bad  Block  Replacement  Control  Task  (RCT) 

The  Bad  Block  Replacement  Control  Task  (RCT)  handles  bad  block 
replacement  and  recovery  on  Mass  Storage  Control  Protocol  (MSCP)  disks 
such  as  the  RA80.  Bad  block  handling  on  MSCP  disks  consists  of  four 
stages:  detecting,  notifying,  replacing,  and  revectoring.  The  disk 
controller  (UDA50 )  detects  bad  blocks  and  notifies  the  driver  (DUDRV) . 
The  driver  activates  RCT.  RCT  performs  the  bad  block  replacement 
functions  that  enable  the  controller  to  revector  (redirect)  I/O  from 
the  bad  block  to  the  replacement  block. 

RCT  also  performs  replacement  and  recovery  on  MSCP  disks  that  went  off 
line  during  bad  block  replacement  or  before  the  contents  of  a 
write-back  cache  were  copied  to  the  disk. 

The  chapter  describes  bad  block  replacement  functions  and  recovery 
techniques . 


Chapter  6  -  Resource  Monitoring  Display  (RMD) 

The  Resource  Monitoring  Display  (RMD)  provides  information  about  the 
active  tasks  in  your  operating  system  and  the  availability  of  system 
resources.  This  information  includes  the  active  tasks,  their  location 
in  memory,  the  amount  of  memory  they  occupy,  and  the  available  pool 
space.  RMD  generates  dynamic  displays  on  CRTs  and  "snapshot"  displays 
on  hardcopy  terminals. 

There  are  three  displays:  memory,  active  task,  and  task  header. 

There  is  also  a  help  page  that  tells  you  how  to  switch  display  pages. 
Each  display  page  has  a  setup  page  from  which  you  can  alter  the 
contents  of  the  associated  display  page.  You  can  access  any  RMD 
display  and  alter  the  contents  of  the  display  from  the  MCR  command 
line. 

On  RSX-11M-PLUS  systems,  a  system  statistics  display  and  error  log 
count  display  are  also  available. 

The  chapter  contains  an  example  and  explanation  of  the  memory  display. 


Chapter  7  -  Setting  Up  and  Running  the  Queue  Manager  (QMG) 

The  Queue  Manager  (QMG)  has  the  primary  function  of  controlling  the 
system’s  line  printers  and  the  print  jobs  that  are  passed  to  them. 
Users  can  specify  the  number  of  copies  they  want  printed,  the  time  the 
job  is  to  be  released  for  printing,  whether  the  file  is  to  be  deleted 
after  printing,  and  which  printer  they  want  to  use.  Users  can  display 
all  information  about  the  QMG  queues  and  can  alter  the  characteristics 
of  jobs  in  queues.  Some  installations  may  have  user-written  output 
processors  that  pass  jobs  to  devices  other  than  line  printers.  The 
nonprivileged  functions  of  QMG  are  documented  in  the  RSX-11M/M-PLUS 
Batch  and  Queue  Operations  Manual . 

This  chapter  documents  the  privileged  system  management  functions  of 
QMG.  Systems  can  have  as  many  as  16  output  queues  (including  the 
default  PRINT  queue)  and  16  output  processors.  Print  processors  can 
be  initialized  to  print  a  specified  number  of  flag  pages  before  each 
print  job,  to  accept  or  reject  print  jobs  specifying  that  lowercase 
printing  is  required,  and  to  handle  many  kinds  of  printed  forms. 
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On  RSX-11M-PLUS  systems,  QMG  also  supports  batch 
RSX-11M-PLUS  systems  can  have  as  many  as  16  batch  queues  and 
processors. 

The  chapter  includes  an  illustrated  explanation  for  setting  up  the 
Queue  Manager. 


Chapter  8  -  The  SHUTUP  Program 

The  SHUTUP  program  allows  a  privileged  user  to  shut  down  the  system  in 
an  orderly  fashion.  SHUTUP  prompts  for  the  number  of  minutes  to  w 
before  shutdown,  the  number  of  minutes  between  shutdown  messages^  and 
the  number  of  minutes  to  wait  before  disabling  logins.  Be  ore  hal ting 
the  system,  SHUTUP  performs  cleanup  functions  such  as  lo99^  °^t  ail 
logged-in  terminals,  submitting  the  user-written  command  file 
LB: [1, 2JSHUTUP.CMD  to  Indirect  for  execution,  st°PP*ngH 
Manager,  Console  Logger,  and  Error  Logger  (if  present),  deallocating 
checkpoint  space,  and  dismounting  mounted  devices. 

The  chapter  provides  an  example  and  explanation  of  SHUTUP  output. 


Chapter  9  -  Terminal  Emulation  and  File  Operations  with  Other  Systems 

A  local  Micro/RSX  terminal  can  log  in  to  and  conduct  an  interactive 
session  with  an  external  computer  system.  This  session  is  established 
using  the  Data  Terminal  Emulator  (DTE) .  The  external  system  can  be  an 
RSX-11M  or  RSX-11M-PLUS  system,  a  Professional  Personal  Computer,  or 
another  Micro/RSX  system.  Once  a  local  Micro/RSX  termina  is  ogge 
in  to  an  external  system,  the  external  system  becomes  the  h?st  system. 
The  host  system  views  Micro/RSX  as  remote.  During  an  m 
session,  files  can  be  transferred  between  the  host  system  and 
Micro/RSX.  Files  are  transferred  using  the  Micro/RSX  i  e  r 
Utility. 


The  chapter  describes  how  to  perform  terminal  emulation  and  file 
operations  between  a  Micro/RSX  system  and  an  external  system,  with 
examples . 


Chapter  10  -  Virtual  Monitor  Console  Routine  (VMR) 

The  Virtual  Monitor  Console  Routine  (VMR)  is  a  task  that  contains  a 
subset  of  the  Monitor  Console  Routine  (MCR)  commands.  You  use  VMR  to 
make  the  same  changes  to  the  system  image  file  on  disk  that  you  would 
make  to  the  running  system  with  MCR.  Some  of  these  changes  are 
setting  the  size  of  pool,  creating  partitions,  loading  drivers,  and 
installing  tasks.  The  advantage  of  using  VMR  is  that  you  can  almost 
completely  configure  a  system  image  file  before  you  bootstrap  l  . 

The  chapter  presents  each  of  the  VMR  commands  in  alphabetical  order. 


Chapter  11  -  Command  Language  Interpreters 

A  command  line  interpreter,  or  CLI,  is  a  task  that  services 
unsolicited  commands  meant  for  the  operating  system  or  a£  application. 
These  commands  are  not  prompted  for  fcy  any  taste  nor  are  they  given  to 
a  task  by  a  read  operation  on  a  terminal.  A  CLI  is  also  an  efficien 
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means  of  interfacing  an  application  command  processor  to  any  number  of 

terminals,  because  no  read  QIO  or  character  AST  processinq  is 
involved.  y 

This  chapter  introduces  the  concepts  of  CLIs  on  RSX-11M/M-PLUS 
systems.  The  chapter  includes  enough  information  to  allow  the 
programmer  to  write  application-specific  CLIs. 


Chapter  12  -  The  DCL  Task 

The  DIGITAL  Command  Language  (DCL)  is  a  general  purpose  command 
language  syntax  implemented  on  several  DIGITAL  operating  systems. 

This  chapter  explains  the  ways  in  which  DCL  can  be  installed  on  your 
system  and  documents  the  means  by  which  the  DCL  task  parses  and 
translates  commands.  In  addition ,  this  chapter  documents  the  Macro 
Meta  Language,  a  set  of  MACRO-11  macros  used  to  define  DCL.  An 
experienced  programmer  can  add  commands  to  DCL  or  remove  them,  or 
alter  DCL  by  changing  parts  of  DCL,  such  as  altering  defaults  or 
eliminating  qualifiers. 


Chapter  13  -  Pool  Monitoring  Support 

Pool  monitoring  support  controls  the  use  of  the  system's  dynamic 
storage  region  (pool) .  This  support  monitors  pool  levels,  restricts 
use  of  pool,  and  notifies  you  when  pool  is  near  depletion.  This 
support  consists  of  two  parts:  the  RSX-11M/M-PLUS  Executive  pool 
monitor  code  and  the  privileged  Pool  Monitor  Task  (PMT) . 

The  chapter  describes  how  to  get  pool  monitoring  support,  the 
conditions  that  affect  PMT,  PMT  defaults,  and  how  to  abort  PMT.  There 
is  also  an  annotated  example  of  PMT  output  for  extreme  fragmentation. 


Chapter  14  -  Shuffler  Support 

The  Shuffler  (SHF)  is  a  privileged  task  that  compacts  space  in 
system-controlled  partitions  when  a  memory  allocation  failure  occurs. 
The  Shuffler  operates  only  within  system-controlled  partitions. 

The  chapter  describes  Shuffler  structure.  Shuffler  interaction  with 
the  operating  system,  ways  to  monitor  the  Shuffler,  and  Shuffler 
algorithms  for  the  operating  system. 


Chapter  15  -  RSX-11M-PLUS  Reconfiguration  Services 

The  reconfiguration  services  consist  of  two  tasks  (CON  and  HRC)  and  a 
driver  (RD:).  With  these  services,  you  can  alter  or  display 
information  about  various  system  resources  such  as  devices  and  memory. 
The  main  purpose  of  the  reconfiguration  services  is  to  allow  you  to 
isolate  faulty  hardware  so  that  it  does  not  affect  the  system 
adversely. 

The  chapter  describes  the  functions  of  CON,  RD:,  and  HRC.  The 
reconfiguration  commands  are  described,  with  examples  of  how  to  use 
each  one.  The  chapter  also  gives  procedures  for  recovering  from 
various  hardware  errors. 
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Chapter  16  -  RSX-11M-PLUS  I/O  Queue  Optimization 

I/O  queue  optimization  is  used  to  improve  the  throughput  of  the  disk 
subsystems  used  in  your  RSX— 11M— PLUS  system*  This  is  done  by  making 
the  most  effective  use  of  the  list  of  I/O  requests  in  the  queue  for  a 
particular  disk  device*  Three  methods  of  optimization  are  provided: 
Nearest  Cylinder,  Elevator,  and  Cylinder  Scan. 

The  chapter  describes  each  of  the  three  methods  of  optimization  and 
how  to  choose  the  one  that  is  best  for  your  system*  There  is  also  a 
list  of  error  messages  given  by  the  SET  /OPT  command. 


Chapter  17  -  RSX-11M-PLUS  Resource  Accounting 

Resource  Accounting  provides  a  transaction  file  of  system  usage 
information.  Information  is  gathered  on  each  user  in  a  system  and  on 
total  system  utilization.  This  information  can  be  used  to  bill 
individual  users  for  the  resources  used  and  for  measuring  overall 
system  performance.  By  analyzing  the  data  in  the  transaction  file, 
you  can  determine  such  things  as  who  used  the  system,  for  how  long, 
how  much  CPU  time  they  used,  and  a  number  of  other  statistics.  For 
system  utilization,  you  can  find  out  the  number  of  users,  number  of 
logins,  how  much  input/output  was  done,  and  other  system  usage 
information.  The  information  in  the  transaction  file  can  be  displayed 
or  you  can  write  a  program  to  access  the  file  and  analyze  the  data. 

The  chapter  describes  how  Resource  Accounting  works  and  contains  an 
example  of  a  transaction  file  output. 


Chapter  18  -  RSX-11M-PLU S  Shadow  Recording 

Shadow  Recording  allows  your  system  to  back  up  all  information  as  it 
is  being  written  to  a  Files-11  disk.  It  does  so  by  creating  two 
identical  disks  called  a  "shadowed  pair."  More  than  one  pair  of  disks 
may  be  shadowed,  but  shadowed  disk  pairs  cannot  overlap.  The  first 
disk  of  the  pair,  the  primary  disk,  is  the  original  disk  that  exists 
whether  or  not  Shadow  Recording  is  active.  You  can  make  any  disk  on 
your  system,  including  the  system  disk,  the  primary  disk  of  a  shadowed 
pair. 

The  chapter  describes  Shadow  Recording,  how  to  prepare  your  system  for 
it,  and  how  to  control  it.  The  Shadow  Recording  commands  and  error 
messages  are  described  in  detail. 


Chapter  19  -  RSX-11M-PL0S  and  Micro/RSX  Disk  Data  Caching 

Disk  data  caching  is  a  feature  on  RSX-11M-PLUS  and  Micro/RSX  systems 
that  enhances  I/O  operations  by  reducing  the  number  of  physical  I/O 
requests  performed  during  a  disk  operation. 

In  addition  to  monitoring  all  I/O  operations  performed  on  disk 
devices,  disk  data  caching  decreases  the  number  of  physical  I/O 
operations  taking  place  on  "cached"  disk  drives  by  using  a  cache 
partition  in  memory.  Copies  of  disk  data  are  placed  in  the  cache 
partition,  making  the  data  available  for  memory-to-memory  transfers 
instead  of  disk-to-memory  transfers  during  an  I/O  request. 

The  chapter  describes  all  of  the  disk  data  caching  features.  You  can 
disable,  override,  modify,  and  monitor  disk  data  caching. 
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Appendix  A  -  Serial  Despooler  (PRT) 

The  Serial  Despooler  Task  (PRT...)  provides  a  means  of  eliminating 
contention  for  the  system  line  printer.  Rather  than  waiting  for  the 
line  printer  to  become  available,  the  task  directs  the  output  intended 
for  the  line  printer  to  a  disk  file. 

This  appendix  briefly  describes  the  Serial  Despooler  Task  and 
documents  Task  Builder  information  for  it. 


Appendix  B  -  RSX-11M/M-PLUS  UFD  CONVENTIONS 

The  RSX-11M  and  RSX-11M-PLUS  operating  systems  observe  a  set  of  User 
File  Directory  (UFD)  conventions  for  files  on  disk.  These  conventions 
provide  a  uniform  and  consistent  method  of  locating,  allocating,  and 
maintaining  a  file  on  disk. 

This  appendix  describes  group  and  member  numbers  and  their  use  in 
identifying  the  contents  of  system  UFDs .  A  section  on  file-naming 
conventions  is  also  included. 
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RSX-11M  and  RSX-11M-PLUS  each  provide  an  Account  File  Maintenance 
Program  (ACNT)  for  creating  and  maintaining  an  account  file  on  a 
multiuser  system.  The  account  file  contains  entries  for  all  User 
Identification  Codes  (UICs)  authorized  within  the  multiuser  protection 
system.  One  UIC  can  have  several  users,  each  user  having  his  or  her 
password.  When  you  try  to  log  in,  the  system  checks  the  HELLO  or 
LOGIN  command  parameters  against  the  account  file  to  determine  whether 
or  not  the  user  should  have  access  to  the  system. 

With  Version  3.0  of  RSX-11M-PLUS ,  passwords  are  automatically 
encrypted  when  a  new  account  is  created.  Once  a  password  is 
encrypted,  the  password  cannot  be  seen.  Therefore,  if  you  forget  your 
password,  you  must  get  a  privileged  user  to  enter  the  ACNT  program  to 
obtain  a  new  password. 

NOTE 

Please  be  aware  that  no  new  user-written  encryption 
routines  will  be  supported  after  Version  3.0. 

However,  encryption  routines  written  prior  to  Version 
3.0  will  continue  to  be  supported. 

If  you  wish  to  change  your  password,  you  must  use  the  SET  PASSWORD 
command  to  do  so.  You  have  to  know  your  old  password  if  you  want  to 
use  the  SET  PASSWORD  command.  If  you  do  not  remember  your  old 

password,  then  a  privileged  user  can  run  ACNT  and  obtain  a  new 
password  for  you.  Each  account  in  the  account  file  contains  the 

following  information : 

•  UIC  (the  account  number) 

•  Password 

•  User's  default  system  device 

•  User's  default  file  protection 

•  First  name 

•  Last  name 

•  User's  Command  Line  Interpreter  (CLI)  if  the  system  has 
multi-CLI  support 

•  Date  and  time  of  the  user's  most  recent  login 

•  The  number  of  times  that  the  user  has  logged  in  to  the  system 
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•  Whether  the  user's  terminal  is  to  be  slaved  after  login 

•  On  RSX-1 1M-PLUS  systems,  a  session  identifier 

•  On  RSX-1 1M- PLUS  systems,  the  user  account  number 


2 . 1  INVOKING  ACNT 

Invoke  ACNT,  from  a  privileged  terminal,  as  follows: 

>RUN  $  A  C  N  T  m 

ACNT  identifies  itself  and  displays  a  list  of  options  after  you  type 
the  RUN  command. 

A  nonprivileged  user  can  use  ACNT  only  to  modify  the  account  entry  for 
his  or  her  password.  (See  the  RSX-1 1M/M- PLUS  MCR  Operations  Manual) . 

On  RSX-1 1M-PLUS  systems,  a  nonprivileged  user  cannot  use  ACNT  to 
modify  the  account  entry  for  his  or  her  password.  If  a  nonprivileged 
user  attempts  to  run  the  ACNT  program,  ACNT  will  print  the  following 
message : 

ACNT  ~~  Cannot  be  run  from  a  rion-privilesied  terminal 
Use  SET  PASSWORD  to  change  sour  password 


2 . 2  ACNT  OPTIONS 

ACNT  is  an  interactive  program  that  allows  privileged  users  the 
following  options: 

•  (C)  Create  an  account  file 

•  (A)  Add  accounts  to  the  file 

•  (E)  Examine  individual  account  entries  in  the  file 

•  (M)  Modify  individual  account  entries  in  the  file 

•  (L)  List  account  entries  in  the  file 

•  (D)  Delete  account  entries  from  the  file 

•  (S)  Sort  the  account  entries  in  the  file 

•  (CTRL/Z)  Exit  from  ACNT 

/ 

ACNT  prompts  you  for  an  option.  Enter  one  of  the  letters  indicated  in 
the  parentheses  above.  The  program  responds  by  requesting  further 
input  or  by  displaying  information  for  the  option  you  selected.  The 
remainder  of  this  chapter  discusses  the  ACNT  options  and  includes 
examples  of  each. 
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2.2.1  Creating  the  Account  File 

The  Create  option  lets  you  create  the  account  file.  Create  the 
account  file  immediately  after  generating  your  system  to  allow  normal 
use  of  the  system.  The  Create  option  allocates  the  account  file 
( LB :  [  0 , 0  ] RSX1 1 . SYS )  and  sets  the  file  protection  so  that  only 
privileged  users  and  privileged  tasks  can  access  the  account  file. 

You  may  copy  and  optionally  extend  the  account  file  using  the 
Peripheral  Interchange  Program  (PIP)  (see  the  RSX- 1 1 M/M- PLU S  Utilities 
Manual).  The  new  copy  will  have  the  default  file  protection, 
therefore,  immediately  run  ACNT.  ACNT  will  detect  the  incorrect 
protection  codes  and  restore  proper  protection. 

The  following  example  shows  how  to  create  the  account  file  on  RSX-11M 
systems.  After  you  invoke  ACNT,  it  responds  with  a  list  of  options 
and  a  prompt,  as  follows: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE? 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRI./Z  -  EXIT 

Enter  option:  C  ® 

E  n  t  e  r  in  a  x  i  m  u  m  n  u  m  b  e  r  o  f  a  c  c  o  u  1 1 1  s  ♦  30  ♦  (ret) 

Enter  a  decimal  number  (n.)  to  specify  the  maximum  number  of  account 

entries  to  be  listed  in  the  file.  The  system  then  creates  an  account 
file  (LB: [0,0]RSX11 .SYS)  large  enough  to  contain  35  accounts. 

When  the  Create  operation  is  complete,  press  the  ESCAPE  key  to  request 
a  list  of  options.  Then  you  can  add  accounts  to  the  account  file. 


2.2.2  Adding  Account  Entries 

The  Add  option  lets  you  add  accounts  to  the  account  file.  ACNT 
prompts  you  for  the  following: 

•  UIC  (the  account  number) . 

•  Password. 

•  User's  default  system  device. 

•  User's  default  file  protection. 

•  First  name. 

•  Last  name . 

•  User's  CLI.  If  your  system  does  not  have  multi-CLI  support, 
ACNT  does  not  prompt  you  for  the  user's  CLI  (MCR  is  the 
default) . 

•  Whether  the  user's  terminal  is  to  be  slaved  after  login. 

•  On  RSX— 1 1M-PLUS  systems,  a  session  identifier. 

•  On  RSX-1 1M-PLUS  systems,  a  user  account  number. 

ACNT  maintains  the  file  in  ascending  order  by  UIC. 
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The  prompts  for  the  password,  first  name,  and  last  name  specify  the 
maximum  number  of  characters  that  ACNT  accepts.  Passwords  can  be  up 
to  39  characters  long,  but  be  aware  that  systems  using  DECnet  can  only 
use  8-character  passwords.  The  legal  characters  for  user  names  and 
passwords  are  as  follows: 

•  A  through  Z,  upper-  and  lowercase 

•  0  through  9 

•  '  (apostrophe) 

•  .  (period) 

•  -  (hyphen) 

•  $  (dollar  sign) 

•  1  (exclamation  point) 

The  default  system  device  prompt  requests  a  device  name  and  unit 
number  (optional  if  0).  ACNT  accepts  logical,  physical,  and  pseudo 
device  names .  The  acceptance  of  logical  and  pseudo  device  names  lets 
you  move  the  user  disk  to  another  drive  without  having  to  change  the 
default  device  in  the  account  file.  When  specifying  the  device  name, 
do  not  include  a  colon  ( : ) . 

RSX-1 1M-PLUS  systems  include  two  additional  prompts:  one  is  for  a 

session  identifier  and  the  other  is  for  the  user  account  number.  The 
session  identifier  and  user  account  number  are  optionally  used  by  the 
Resource  Accounting  Program  (see  Chapter  17).  The  session  identifier 
is  also  used  by  the  HELLO  program  (see  the  RSX-1 1M/M-PLUS  MCR 
Operations  Manual ) . 

The  following  example  shows  how  to  add  entries  to  the  account  file  on 
RSX-1 1M  systems: 

Options  aret  A  -  ADD?  C  -  CREATE  FILE?  D  -  DELETE?  E  -  EXAMINE? 

L  -  LIST?  M  -  MODIFY?  S  -  SORT?  CTRL./Z  -  EXIT 

E  r  1 1  e  r  o  p  t  i  o  n  t  A  (REf) 

E  r  1 1  e  r  a  c  e  o  u  n  t  o  r  <  E  S  C  >  f  o  r  o  f  t  ions  <  N  ?  N  )  ♦  5  ?  1 5  (ret) 

Password  (  039  chars*  >J  A1B2C3  (ret) 

D  e  f  a  u  1 1  s  y  s  t  e  m  d  e  v  ice  <  D  D  U  )  t  DB  (ret) 

F  i  r  s  t  n  a  m  e  <  <  -  1 2  c  h  a  r  s  ♦  )  l  J  A  N  E  (RET) 

Last  name  (  014  chars*  >:  BARRETT  ® 

Default  file  protection  (  CSY  ?  GW  ?  GR  ?  WOH  >*♦  RWED  ?  RWED »  RWED  ?  R  (ret) 

E n t e r  u s e  r  C L I  ( d e f a u 1 1  =  M C R ) X  DC L  ® 

8 1  a  v  e  l  e  r  \u  i  n  a  1  ?  C  II Y  /  N II  lit  M  (ret) 

UFD  DB1 J  f  II 005?  015  3  J 

In  this  example,  ACNT  creates  an  account  in  the  account  file  for  Jane 
Barrett.  Jane's  password  is  A1B2C3  and  her  default  system  device  is 
DBO:.  Her  default  file  protection  is  read,  write,  extend,  and  delete 
access  for  system,  owner,  and  group;  the  world  has  read-only  access. 
(This  is  also  the  system  default  protection.)  Jane's  CLI  is  DCL ,  and 
her  terminal  is  not  slaved  after  login. 

ACNT  remains  in  Add  mode  until  you  press  the  ESCAPE  key  to  request  a 
list  of  options. 
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The  following  example  shows  how  to  add  an  account  to 
system. 

RSX-1 1M-PLUS  Account  File  Maintenance  Program 
Account  Utility  options  areJ 


an  RSX-1 1M-PLUS 


Add 

D  e  1  e  t  e 
E x  a  m  i  n  e 
L  i  s  t 
Modi f y 
Sort 
CTRL/Z 

Ente r  opt i on 


Add  an  account  to  file 
Delete  an  account  file  entry 
E  x  a  m  i  ri  e  e  x  i  s  t  i  n  <3  a  c  e  o  u  n  t 
L.  i  s  t  a  e  c  a  u  n  t  f  :i  1  e 
M  o  d  i  f  y  a  c  c  o  u  n  t  f  i  1  e 
8  o  r  t  a  c  c  o  u  n  t  f  :i  1  e 
T  e  r  ni  i  n  a  t  e  u  t  i  1  i  t  y  s  e  s  s  i  o  n 


E ri  t e  r  a e e o u n  t  <  d  k  oup  ? 

hi  e  m  b  e  r  )  t 

1 0  ?  1 0  © 

D  e  f  3  u  1  i  s  y  s  t.  e  m  d  e  v  :i.  ■ 

ce 

<  ddu  > : 

DUO  © 

P  a  s  s  w  o  v  d  (  3  9  c  h  a  r  s  * 

or 

fewer) t 

BASEKITPL 

© 

F  :i.  r  t  n  a  m  e  <12  e  h  a  r 

s  * 

or  fewer) 

\  K  a  t  h lee  n 

© 

t...  a  s  t  n  a  m  e  ( 1 4  e  h  a  r  s  v  o  r 
I?  e  f  a  u  1 1  f  :i.  1  e  p  r  a  t  e  c  t  i  o  r  t 


fewer)*  B  e  a n 
(CSYr0W»6R»W.0:3) 


CRWFD»RWF.D»  RfRl  © 

Enamel >  $  KATHLEEN 


D e f  a u  1 t  d  i  r e c  t o  r y  s t  r  i  n d  (  C  d rou p  f  iti e m b e  r  1 
Session  ident  <3  chars*  or  fewer )t  KIM  ® 

A  c  e  o  u  n  t  n  u  iri  b  e  r  (  4  d  i  <2  i  t  s  o  r  f  e  w  e  r  )  ♦  23  © 

E  n  t  e  r  u  s  a  r  C  L I  (  d  e  f  a  u  1 1  -•  D  C  L )  t  © 

Slave  terminal?  CY/Nlt  N  © 

D  i  s  a  b  1  e  1  o  si  i  n  / 1  o  &  a  u  t  m  e  s  s  a  si  e  s  ?  E  Y  /  N  3  t  N  ® 

In  this  example,  ACNT  created  an  account  for  Kathy  Bean.  Kathy's 
password  is  BASEKITPL,  which  is  encrypted  by  ACNT  when  the  account  is 
created.  Her  default  file  protection  is  read,  write,  extend,  and 

delete  access  for  system  and  owner,  and  read  only  access  for  group  and 
world.  Her  default  directory  string  (which  must  be  9  characters  or 

fewer)  is  KATHLEEN,  and  her  default  system  device  is  DUO:.  Her 

session  identifier  is  KLM,  her  account  number  is  23,  her  CLI  is  DCL 

(because  she  specified  the  default),  and  her  terminal  is  not  slaved. 
Login  and  logout  messages  are  not  disabled. 

After  her  account  has  been  created,  and  the  system  has  finished 
prompting  for  all  the  necessary  information,  the  system  returns  the 
following  message: 


t*  c  e  o  u  1 1 1  e  r  >  t  r  y  a  n » I  d  i  r  e  e  t  o  r  y  h  v  e  b  e  e  n  c  r  e  a  t  e  d  * 


2.2.3  Examining  Account  Entries 

The  Examine  option  displays  two  lines  of  detailed  information  for  each 
account  in  the  account  file  on  RSX— 11M  systems.  The  first  line 
contains,  from  left  to  right,  the  following  information: 

•  UIC 

•  Password 

•  First  name 

•  Last  name 

•  User's  default  system  device 
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The  second  line  contains  the  following  information: 

•  Date  of  the  last  login. 

•  Time  of  the  last  login. 

•  Number  of  times  the  user  has  logged  in  to  the  system. 

•  User's  CLI.  If  your  system  does  not  have  multi-CLI  support, 
ACNT  displays  the  default  CLI  (MCR) . 


•  Whether  the  user's  terminal  is  to  be  slaved  after  login. 


The  following  example  shows  how  to  display  information  for  an  account 
on  an  RSX-11M  system: 

Options  aret  A  -  ADD  *  C  -  CREATE  FILE?  D  -  DFLETE*  E 
L.  -  LIST  ?  M  -  MODIFY  r  S  -  SORT  r  CTRL/Z  -  EXIT 
E n t e  r  op  t  x  o n  :  E  (ret) 

Enter  account  or  <ESC>  for  options  <  N  >  N  )♦  5  >  1  4  (gj) 

CCOOSt 01433  007  SEAN  C0NN0IT 

03/05/81  15t 05: 55  00001  DCL  N 

In  this  example,  Sean  Connoit's  account  is  examined.  The  first  line 
lists  his  UIC  ([005,014]),  password  (007),  first  name,  last  name,  and 
default  system  device  (DBO:).  The  second  line  displays  the  date  of 
his  last  login  (03/05/81),  the  time  of  his  last  login  (15:05:55),  the 
number  of  times  he  has  logged  in  (00001),  his  CLI  (DCL),  and  the 
slave/no-slave  status  of  his  terminal  (N). 


-  EXAMINE  ? 


DBO  ♦ 


ACNT  remains  in  Examine  mode  until  you  press  the  ESCAPE  key  to  request 
a  list  of  options. 

The  following  example  shows  how  to  display  information  for  an  account 
on  an  RSX-11M-PLUS  system: 

R3X~ 1 1M-PLUS  Account  File  Maintenance  Program 


Account 
Add 

Delete 
E  x  a  in  i  n  e 
L  i  s  t 
Mod i f y 
8  o  r  t 
CTRL/Z 

E  n  t  e  r  o  p  t  i.  o  n  : 

Ent e r  account 
2  5  -  A U 0-85  08 : 30 : 02 
Owner  *  C0100103 
Lname  -  BEAN 
DefCLI  =  DCL 
Total log ins  ®  2 
C  h  a  r  a  c  t  e  r  i  s  1 1  c  s  -• 

D  e  f  P  r  o  t  e  c  t  i  o  n 


Utility  options  are: 

A  d  d  a  n  a  c  c  o  u  n  t  t  o  f  i  .1  e 
Dele  t e  a n  a c  c o  u  n t  f i 1 e  e  n t r y 
E  x  a  m  i  n  e  e  x  i  s  t  i  n  g  a  c  e  o  u  n  t 
L  i  s  t  a  c  c  o  u  n  t  f  i  1  e 
Modify  account  file 
S  o  r  t  a  c  e  o  u  n  t  file 
T  e  tv  m  i  n  a  t  e  u  til  :i.  t  y  s  e  s  s  i  o  n 

e  m 

( g r o u p ?  member):  1 0  > 1 0  ® 

RSX-11M-PLUS  Multiuser  Account  File  List  Page  1 
Logindef aults  ~  DU00 ♦ EKATHY3 
Friame  «  KATHY  Password  »  (FNCRYPTED) 
Session  ID  «  KI..H  Account  ~  23 
Last  login  «  24--AUG-85  12J46S22 
-•  N  0  S 1  v «  ?  D  e  f  d  i  r  s  t  r  i.  n  S  == 

CRWED  ?  RUED  t R ?  R3 


In  this  example,  Kathy  Bean's  account  is  examined.  The  first  line  of 
the  display  lists  her  UIC  [010,010]  and  her  login  defaults  (her 
default  system  device  is  DUO:  and  her  default  directory  string  is 


2-6 


THE  ACCOUNT  PILE  MAINTENANCE  PROGRAM  ( ACNT ) 


[KATHY]).  The  next  line  of  the  display  lists  her  last  name,  first 
name,  and,  in  the  password  field,  (ENCRYPTED)  is  displayed.  If  any  of 
the  passwords  in  any  accounts  that  are  being  examined  are  encrypted# 
the  password  field  will  display  (ENCRYPTED)  instead  of  the  password 
itself.  The  third  line  displays  Kathy's  CLI  ( DCL ) ,  her  session 
identifier  (KLM) ,  and  her  account  number  (23).  Next,  her  total  number 
of  logins  and  last  login  are  displayed.  The  fifth  line  of  the  display 
shows  Kathy's  terminal  characteristics  (her  terminal  is  set  to 
noslave)  and  her  default  directory  string  is  left  blank,  because  it  is 
also  her  login  default,  which  is  shown  in  the  first  line  of  the 
display.  The  last  line  of  the  display  shows  Kathy's  default  file 
protection . 

After  examining  an  account,  or  a  group  of  accounts,  ACNT  prompts  you 
with  the  following  message: 

Ke«  <RETURN>  to  continue?  CTRL/2  for  ACNT  options  menuJ 


2.2.4  Modifying  Account  Entries 

The  Modify  option  allows  you  to  change  the  password,  default  system 
device,  default  file  protection,  first  name,  and  last  name  for  an 
account,  and  the  slave/no-slave  status  of  a  terminal.  You  can  change 
the  CLI  of  an  account  if  your  system  includes  the  multi-CLI  option. 

In  an  RSX-11M-PLUS  system,  the  Modify  option  also  allows  you  to  change 
the  session  identifier  and  the  account  number. 

After  you  specify  the  account  to  be  modified,  the  program  displays  an 
account  entry  and  asks  for  verification.  Type  either  Y  (Yes)  or  N 
(No)  to  indicate  that  the  correct  account  was  or  was  not  specified. 
If  you  specify  N,  ACNT  searches  the  file  for  another  entry  with  the 
same  UIC.  When  you  enter  a  Y,  ACNT  prompts  for  the  entry  details. 
Press  the  ESCAPE  key  if  you  do  not  want  to  change  an  item. 

The  following  example  shows  how  to  modify  account  information  on  an 
RSX-11M  system: 

EXAMINE ? 


DBOJ 


In  this  example,  Barbara  Spencer's  account  is  modified.  Her  password 
(BARB)  is  changed  to  BES,  and  her  CLI  (MCR)  is  changed  to  DCL.  ACNT 
remains  in  Modify  mode  until  you  press  the  ESCAPE  key  to  request  a 
list  of  options . 


Options  are!  A  ~  ADD?  C  -  CREATE  Fit. E  ?  D  ~  DELETE?  E  - 
L  -  LIST?  M  -  MODIFY?  S  -  SORT?  CTRL/2  -  EXIT 
Enter  option »  M  ® 

Enter  account  or  <ESC>  for  options  (  N?N  )*  5? 12  © 

C  COOS  ?  0123 1  BARB  BARBARA  SPENCER 

03/05/81.  3.5  5  00  *.  1.1.  00006  MCR  N 

This  entry  ?  CCY/NllS  Y  ® 

Type  <ESC>  to  leave  entry  unchanged 
Password  (  <  =  39  chars.  )  *.  BES  ® 

Default  system  device  (  DDU  >1  (Esc) 

First  name  <  01.2  chars.  >! 

Last  name  (  <=14  chars.  ) 1  HD 
Enter  user  CLI  ( def ault=MCR ) J  DCL  ® 

Slave  terminal?  C  C  Y/NI I !  (Is5) 
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The  following  example  shows  how  to  modify  account 
RSX-1 1M-PLUS  system: 


information  on  an 


RSX~11M~PLUS  Account  File  Maintenance  Program 


Account 
Add 

Delete 
Exam ine 
L.  i  s  t 
Modify 
Sort 


Utility  options  are* 

Add  an  account  to  file 
Delete  an  account  file  entry 
E  x a  m ine  existing  a  c  c  o u n t 
L i s t  account  file 
M  a d i f  y  a  c  c  o  u n t  file 
S o r  t  accou n t  f i 1 e 
Ter  in  i  n  a  t  e  u  t  i  1  i  t  y  s  e  s  s  i  o  n 
M  ® 

(  g  r  o  u  p  y  member)*  1. 0  r  1 0  (ret) 

L  ogindef au3  ts 


CTRL/Z 

E r i ter  op  t i o n  t 
Enter  account 
Owner  *  C0100103 
Lname  ~  BEAN 
Def  CL.  I  *  DCL 
Total logins  ™  2 
C h a r a c t e r i s t i c s  «  N OSlave 
Def  Protection  *  r.RUED  ?  RWED  ?  R  ?  R!3 
This  entry  ?  ICY /Hill  Y  ® 

T y p e  < ESC >  t o  leav e  e n t r y  u n c h a n g e d 
P  a  s  s  w  o  if' d  (  3  9  c  h  a  r  s  ♦  o  r  f  ewer)  ♦  (esc) 

D  e  f  a  u  1 1  s  y  s  t  a  m  d  &  v  i  c  e  (  0  D I J  )  t  (ESC) 

F i  r s t  n a m e  ( 1 2  c h a r s  *  or  fewer  )  *  (ES 


*  HUGO tr KATHY! 

Fname  «  KATHY  Password  *  (ENCRYPTED) 
Session  ID  ~  KLH  Account  ~  23 
Last  login  «  24-AUG-S5  121A6122 
D efdirstr i n g  » 


L  a '  t  n  a  m  e  <14  c  h  a  r  s  ♦  o  r 
D  &  f  a  u  3  t  f  i  1  e  p  r  o  t  e  c  t  i  o  n 


fewer  )t  (ESC) 

<  CSY>QU*GR>WG!  )  ? 


D  e  f  a  u  1 1  >1  :i.  r  e  c  t  dry  s  fc  r  i.  n  g  KATHLEEN 
N e w  d i r e c t o r y  h a s  h e e n  c  reated 
E n  t e i'  u s e  v  C L I  <  d e f  a u  1 1  =  DC l.. )  l  (ESC) 

Slave  terminal? 

D  :i  s a b  3.  e  1  o g  i  n /  3  o g o u t  messages?  L  Y / N 1 1  (ESC) 

S  e  s  s  i  o  ri  i  d  e  n  t  i.  f  i.  e  t'  <  3  cr  h  a  r  s  *  o  r  fewer)*  K  K  K 
A c c o *.j r» t  n t f m b er  (4  digits  or  fewer)  J  (ESC) 


In  this  example,  Kathy  Bean's  account  is  modified.  Her  default 
directory  string  is  changed  to  KATHLEEN,  and  her  session  identifier  is 
changed  to  KKK . 

When  she  changed  her  default  directory  string,  the  system  printed  the 
message : 

N  e  w  d  i  r  o  e  t  o  r  'a  h  a  s  b  e  e  n  created* 

After  ACNT  has  prompted  you  for  changes  to  all  the  account  fields,  it 
prompts  you  with  the  following  message: 

K e y  < R E T !.j R N >  t o  c o n t  i n u e  ?  C T R l.  / 7  for  ACNT  o p t  i o n s  me n u  t 


2.2.5  Listing  Account  Entries 

The  List  option  either  displays  on  the  user's  terminal  or  spools  to 
the  line  printer  all  account  entries  in  the  account  file  or  a 
specified  group  of  entries.  If  you  specify  the  line  printer,  ACNT 
creates  the  file  ACCNT.DMP.  This  file  contains  the  account 
information  you  specified.  ACNT  prints  the  file  if  the  spooler  is 
installed  in  your  system.  If  the  spooler  is  not  installed,  you  may 
print  ACCNT.DMP  after  you  exit  from  ACNT. 
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The  following  example  shows  how  to  list  account  entries  on  an 
RSX-11M-PLUS  systems 

RSX-11M-PLIJS  Account  File  Maintenance  Program 


Account  Utility  options  are: 


Add  an  account  to  file 
Delete  an  account  file  entry 
E  x  a  rn  i  n  e  e  x  i  s  t  i  n  s  a  c  c  o  u  n  t 
L  i  s  t  a  c  c  o  u  n  t  f  i  1  e 
Modify  account  file 
S  o  r  t  a  c  c  o  u  n  t  f  i  1  e 
T  e  if'  hi  i  n  a  t  e  utility  s  e  s  s  i  o  n 


Add 

Delete 
Examine 
List 
Modify 
S  o  r  t 
CTRL /Z 
E n ter  op t i o n :  l •  © 

Only  the  old  UNENCRYPTED  type  passwords  can  he  printed 
Print  passwords  (default  no)?  CY/N3J  ® 

A 1 1  account s  ( def  au  1 1  no  )  ?  II Y/N 1  ♦  © 

List  cm  TerminaKdefault)  or  File  <  ACCOUNT  ♦  DMP  >  CT/FII :  ® 

If  any  of  the  passwords  are  encrypted,  the  password  field  will  display 
(ENCRYPTED)  instead  of  displaying  the  password  itself. 

After  all  the  accounts  you  have  specified  have  been  listed,  ACNT 
returns  the  following  prompt: 

Key  <RETURN>  to  continue*  CTRL/Z  for  ACNT  options  menu: 

On  RSX-11M  systems,  this  option  lists  accounts  in  the  same  manner. 
However,  RSX-11M  systems  do  not  support  password  encryption.  When  the 
list  operation  is  complete,  ACNT  displays  its  options  and  prompts  for 
a  choice. 


2.2.6  Deleting  Account  Entries 

The  Delete  option  eliminates  individual  accounts  from  the  file.  After 
you  specify  the  account  to  be  deleted,  ACNT  displays  the  account  entry 
and  requests  a  Y  (Yes)  or  N  (No)  response  for  verification.  If  the 
response  is  N,  ACNT  searches  for  another  account  with  the  same  UIC. 
If  the  response  is  Y,  ACNT  asks  if  you  want  to  delete  the  account's 
UFD  and  other  files.  Another  Y  response  deletes  these  files.  If  you 
enter  N  in  response  to  the  deletion  query,  the  account's  files  and  UFD 
are  left  intact. 

The  following  example  shows  how  to  delete  accounts  from  the  account 
file  on  an  RSX-11M  system: 

Options  are:  A  -  ADD*  C  -  CREATF  FILE*  D  -  DFLETF*  F 

L  -  LIST?  M  -  MODIFY?  S  -  SORT*  CTRL/Z  -  EXIT 

E  n  t  e  r  o  p  t  i  o  n  :  D  ® 

E  n  t  e  v  a  e  c  o  u  ri  t  o  r  <  E  S  C  >  f  o  r  o  p  t  i  o  n  s  (  N  *  N  )  :  5  ?  1  2  ® 

C  C 005  *  012 IN  MLK  MAUREEN  KACZKA 

08/06/85  08:46:51  00004  DC1.  N 

This  entry  ?  C C Y/N 11 X  Y  ® 

Delete  UFD  and  files?  CC  Y/N  II  It  Y  © 

PIP  DB1.  J II 11005  *  01211 1*  ♦  *  t  %/ DE 

>  p  i  p  1 1  b  i :  r.  c  o  *  o  1 3  o  o  5  o  1 2  ♦  d  i  r  *  *  /  d  e 

In  this  example,  ACNT  deletes  Maureen  Kaczka's  UFD  and  files. 


-  EXAMINE? 


DB1 : 


2-9 


THE  ACCOUNT  FILE  MAINTENANCE  PROGRAM  (ACNT) 


The  following  example  shows  how  to  delete  accounts 
file  on  an  RSX-11M-PLUS  system. 


from  the  account 


RSX-ilM-PLUS  Account  File  Maintenance  Program 
Account  Utility  options  are* 


Add 

Delete 
Examine 
List 
Modify 
Sort 
CTRL/Z 
Enter  option*  D  ® 

Enter  account  (group*  member)*  10*10 


Add  an  account  to  file 
Delete  an  account  file  entry 
Examine  existing  account 
List  account  file 
Modify  account  file 
Sort  account  file 
Terminate  utility  session 


LoSindefaults  =  DU00  5  I  KATHY 1 
F name  «  KATHY  Password  =  (ENCRYPTED) 
Session  ID  ~  KLH  Account  *  23 
Lasting in  =  24-AUG-85  12146122 
Def dirstring  = 


Owner  *  C.010010I 
Lname  =  BEAN 
DefCLI  =  DCL 
Total logins  -  2 
Characterist ics  =  NOSlave 
Def Protect ion  =  CRWED * RWED * R * R3 
This  entry?  L Y / N 3 :  Y  ® 

Delete  UFD  and  files?  CY /Hit  Y  ® 

Account  entry  has  been  deleted 

In  this  example,  ACNT  deletes  Kathy  Bean's  account  and  files. 


2.2.7  Sorting  Account  Entries 

The  Sort  option  sorts  the  account  entries  in  ascending  order  by  UIC. 
The  following  example  shows  how  to  sort  the  account  file  on  an  RSX-11M 
system: 


Options  are:  A  -  ADD*  C  -  CREATE  FILE*  D  -  DFLETF*  F  -  EXAMINE* 

L  -  LIST*  M  -  MODIFY*  S  -  SORT*  CTRL/Z  -  EXIT 

Enter  option t  S  ® 

When  the  sort  operation  is  complete,  ACNT  displays  all  its  options  and 
prompts  for  a  choice. 

The  following  example  shows  how  to  sort  the  account  file  on 

RSX-1 1M-PLUS  systems: 

RSX-ilM-PLUS  Account  File  Maintenance  Program 

Account  Utility  options  are* 

Add  Add  an  account  to  file 

Delete  Delete  an  account  file  entry 

Examine  Examine  existing  account 

List  List  account  file 

Modify  Modify  account  file 

Sort  Sort  account  file 

CTRL/Z  Terminate  utility  session 

Enter  option*  S  ® 

After  the  sort  operation  is  complete,  ACNT  returns  the  following 

message  and  then  redisplays  the  ACNT  menu: 

Account  file  is  now  sorted  by  UIC 
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2.2.8  Exiting  from  ACNT 

The  Exit  option  allows  you  to  exit  from  the  ACNT  program.  The 
following  example  shows  how  to  exit  from  ACNT  on  RSX-11M  systems: 

Options  are:  A  -  ADD  >  C  -  CREATE  FILEf  0  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
E  n  i  e  v  o  p  t  i  o  n  ♦  (ctrl/z)  (ret) 

When  you  exit  from  ACNT,  ACNT  displays  the  following  message  on  your 
terminal : 


OPERATION  COMPLETE 


The  following  example  shows  how  to  exit  from 

ACNT  on  RSX-11M— PLUS 

systems : 

RSX-ilM- 

PLUS  Account  File  Maintenance 

Program 

Account  Utility  options  aret 

Add 

Add  a  n  a  c c  o u  n  t  t  a  f  i  1 e 

Delete 

Delete  an  account  file  entry 

E  x  a  m  i  n  e 

E  x  a  m  i  rt  e  e  x  1st  i  n  S  a  c  c  o  u  n  t 

L  i  s  t 

List  account  file 

Modify 

H  o  d  i  f  y  a  c  c  o  u  n  t  f  i  1  e 

Sort 

Sort  account  file 

CTRL/Z 

Terminate  util ity  session 

Enter  option: 

fcTRL/z) 

When  you  exit  from 

ACNT,  ACNT  returns  the  following  message: 

Account  file 

m o d i f i c a t i o n  is  complete 

2.3  ERROR  MESSAGES 

The  ACNT  program  returns  the  following  error  messages: 

ACNT  —  Account  already  exists 

Explanation:  You  attempted  to  add  an  account  with  a  UIC  and 

password  that  already  exists  in  the  account  file. 

ACNT  —  Account  file  already  exists 

Explanation:  You  attempted  to  create  an  account  file  that 

already  exists. 

ACNT  —  Account  file  error 

Explanation:  The  program  detected  an  I/O  error  while 

processing  the  account  file. 

ACNT  —  Account  file  full 

Explanation:  The  account  file  is  full?  you  cannot  add 

further  accounts.  See  the  description  of  the  Create  option 
for  details  on  how  to  enlarge  the  account  file. 

ACNT  —  Cannot  find  account 

Explanation:  You  attempted  to  delete,  examine,  or  modify  an 

account  that  does  not  exist. 
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ACNT  —  Invalid  default  device  name 

Explanations  The  default  system  device  specified  is  not  a 
directory  device. 

ACNT  —  Warning  **  Device  does  not  exist  on  current  system.  OK? 
CY/N]s 

Explanation:  The  specified  default  device  is  not  in  the 
system.  If  you  enter  Y,  ACNT  retains  the  device  name  as  a 
logical  device  name.  ACNT  prompts  again  for  the  device  name 
if  you  enter  N. 

ACNT  —  Invalid  option 

Explanations  In  response  to  the  Enter  options  prompt,  you 
did  not  specify  A,  C,  D,  E,  L,  M,  S,  or  CTRL/Z,  which 
represent  valid  ACNT  options . 

ACNT  —  Listing  file  error 

Explanations  When  you  use  the  List  option,  ACNT  opens  the 
file  SY: [current  uic]ACCNT . DMP .  This  message  indicates  that 
ACNT  cannot  open  the  file;  for  example,  the  device  is  full 
or  it  does  not  contain  a  UFD  for  the  current  UIC.  If  the 
device  is  full,  delete  some  files.  Create  a  new  UFD  if 
there  is  no  UFD  for  the  current  UIC. 

ACNT  —  Syntax  or  command  input  error 

Explanations  You  typed  an  invalid  character.  Enter  the 
correct  data. 

ACNT  —  Workfile  -  dyn.  mem.  exhausted 

Explanations  There  is  insufficient  dynamic  memory.  Install 
the  task  in  a  larger  partition,  or  install  it  with  a  larger 
increment . 

ACNT  —  Workfile  -  virtual  storage  exceeded 

Explanations  The  workfile  exceeds  virtual  memory. 


CHAPTER  3 


THE  CONSOLE  LOGGER 


The  Console  Logger  consists  of  a  driver  (CODRV)  and  a  task  (COT...) 
which  together  control  I/O  to  the  console  output  device  (CO:)  and 
record  time-stamped  system  messages  on  a  terminal,  in  a  log  file,  or 
both.  You  select  support  for  console  logging  during  system 
generation. 

For  RSX-11M  systems,  console  logging  is  available  only  on  mapped 
systems . 


3.1  THE  CONSOLE  OUTPUT  DEVICE  (CO:) 

Your  system  has  a  console  output  device  (CO:)  and  a  console  terminal. 
When  the  Console  Logger  is  active,  I/O  to  CO:  is  controlled  by  the 
console  output  task  (COT...)  and  the  console  driver  (CODRV).  When  the 
Console  Logger  is  not  active,  CO:  is  a  pseudo  device,  and  I/O  to  CO: 
is  controlled  by  the  terminal  driver.  In  both  cases,  output  to  CO: 
can  be  forwarded  to  a  terminal  that  you  assign  as  the  console 
terminal . 


3.1.1  CO:  as  a  Pseudo  Device 

As  mentioned  in  the  previous  section,  CO:  is  a  pseudo  device  when  the 
Console  Logger  is  not  active.  You  can  redirect  CO:  to  any  terminal 
on  your  system  using  the  MCR  REDIRECT  command.  The  terminal  driver 
controls  all  I/O  to  CO:  that  is  redirected  to  the  console  terminal. 


3.1.2  CO:  with  the  Console  Logger  Active 

When  the  Console  Logger  is  active,  the  console  driver  (CODRV)  and  the 
console  output  task  (COT...)  control  all  I/O  to  CO:.  You  use  a 
console  logging  command  to  assign  the  console  terminal  (see  Section 
3.4.5)  rather  than  redirecting  CO:  by  means  of  the  MCR  REDIRECT 

command . 

There  are  two  advantages  to  using  the  console  logger  to  control  I/O  to 
CO:.  These  are  as  follows: 

1.  Console  logging  allows  you  to  record  messages  sent  to  CO:  in 
a  log  file.  You  can  record  messages  on  the  console  terminal, 
in  the  log  file,  or  both.  This  flexibility  enables  you  to 
inspect  the  log  file  at  any  time  and  to  free  a  terminal  when 
you  do  not  need  an  on-line  display  of  console  logging. 
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2.  The  console  logger  time-stamps  messages  to  CO:  that  have  not 
been  time-stamped  by  the  task  issuing  the  message  in  the 
following  forms 

hhsmmsss  hours,  minutes,  and  seconds. 

Also,  prior  to  outputting  the  first  message  after  a  change  of 
date,  the  Console  Logger  outputs  the  current  time  and  date. 


3.2  INSTALLING  COT. ..  AND  LOADING  CODRV 

If  you  select  console  logging  at  system  generation  time,  SYSGEN 
installs  the  console  output  task  (COT...)  and  loads  the  console  driver 
(CODRV)  by  including  the  appropriate  commands  in  SYSVMR.CMD.  You  only 
need  to  install  COT...  and  load  CODRV  if  one  of  the  following 
conditions  exists  s 

1 .  You  have  removed  one  or  both  of  them  and  want  to  restore 
console  logging. 

2.  You  have  altered  SYSVMR.CMD  to  eliminate  them. 


3.3  COMMUNICATING  WITH  THE  CONSOLE  LOGGER 

You  can  use  MCR  commands  to  communicate  with  the  Console  Logger. 
Tasks  use  the  CODRV  driver  to  communicate  with  the  Console  Logger. 


3.3.1  User  Communication  with  the  Console  Logger 

COT...  is  a  privileged  task.  From  a  privileged  terminal,  you  issue 
console  logging  commands  to  start  and  stop  console  logging,  assign  the 
console  terminal,  and  specify  the  console  log  file.  Table  3-1 
summarizes  the  console  logging  commands.  There  are  no  DCL  equivalents 
for  the  console  logging  commands.  Section  3.4  discusses  each  console 
logging  command  in  detail.  These  commands  are  processed  by  the 
COT ...  task . 


3.3.2  Task  Communication  with  the  Console  Logger 

Tasks  communicate  with  the  console  driver  (CODRV)  by  issuing  QIOs. 
CODRV  handles  QIOs  to  COs  for  reading,  writing,  attaching,  and 
detaching.  All  other  I/O  functions  to  CO:  are  passed  to  the  terminal 
driver  as  if  they  were  issued  directly  to  the  console  terminal. 


3. 3. 2.1  Writing  to  CO:  -  Tasks  can  issue  QIOs  to  print  system 
messages  on  the  console  terminal  or  write  system  messages  in  the 
console  log  file.  For  example,  HELLO  issues  a  QIO  to  print  a  message 
to  the  console  terminal  each  time  a  user  logs  in  to  the  system. 

Messages  to  CO:  may  begin  with  a  CTRL/G  to  ensure  that  COT...  sends 
the  message  to  the  most  recently  assigned  console  terminal,  even  if 
you  have  disabled  the  console  terminal  by  specifying  the  NOCOTERM 
option  (discussed  in  Section  3.4.4). 
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The  buffer  in  COT...  accepts  messages  not  longer  than  256(10)  bytes. 
Note  that  using  the  MCR  SET/ BUFFERS I ZE  command  to  set  the  buffersize 
of  device  CO:  does  not  affect  this  restriction.) 


Table  3-1 

Summary  of  Console  Logging  Commands 


MCR  Command 


Meaning 


SET  /COLOG 

SET  /COLOG=ON 

SET  / COLOG=OFF 

SET  /COLOG/NOCCOTERM] 

SET  / COLOG / COT [ ERM ] [ =TTnn : ] 

SET  /COLOG/NOLOGFILE 

SET  /COLOG /LOG [ FILE ] [=[ f ilespec] ] 


Displays  the  current 
console  terminal  and 
logfile  assignments 

Starts  console  logging 

Stops  console  logging 

Disables  the  console 
terminal 

Enables  the  console 
terminal  or  changes  the 
console  terminal  assignment 

Disables  the  logfile 

Enables  the  console  logfile 
or  changes  the  logfile 
assignment 


3. 3. 2. 2  Reading  from  CO:  -  Tasks  can  issue  QIOs  to  read  input  from 
the  console  terminal.  For  example,  an  operator  can  use  the  console 
terminal  to  respond  to  prompts  by  a  system  task  that  require  user 
input.  COT...  does  not  record  messages  in  the  log  file  that  are  read 
from  the  console  terminal. 


3. 3. 2. 3  Attaching  and  Detaching  CO:  -  Tasks  may  attach  to  CO:; 
however,  the  attach  is  a  NOP.  Though  tasks  may  attach  or  detach  CO: 
they  are  not  allowed  exclusive  access  to  CO:. 


3.4  CONSOLE  LOGGING  COMMAND  DESCRIPTIONS 

You  use  console  logging  commands  to  perform  the  following  functions: 

•  Display  the  current  console  terminal  and  log  file  assignments 

•  Start  and  stop  console  logging 

•  Change  the  console  terminal  and  log  file  assignments 

•  Disable  the  console  terminal  or  the  log  file 
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The  general  format  of  console  logging  commands  in  MCR  is  as  follows: 

>SET  / COLOG[ [MCRoption] ] . . . 
where  s 

SET  The  MCR  SET  command 

COLOG  Console  logging  keyword 

MCRoption  One  of  the  console  logging  functions .  You  can  truncate 

these  options  to  three  letters. 


3.4.1  Displaying  the  Current  Console  Terminal  and  Log  File 
Assignments 

display  the  current  console  terminal  and  log  file  assignments,  type 
the  following: 

>SET  /COLGG 

Use  this  option  to  determine  if  the  Console  Logger  is  active.  When 
the  Console  Logger  is  active,  COT...  displays  the  current  console 
terminal  and/or  log  file  assignments.  For  example: 

> SET  /COL.OG 
COT  — 

Console  =  TTOOOJ 

Loaf i 1 e  =  DB0005 CCl r431CONSOLE.LOG j 1 

If  the  Console  Logger  is  not  active,  the  display  option  indicates  the 
following : 

COT  — 

Console  *  None 
L  o  <4  f  i  1  e  «  Non  e 


3.4.2  Starting  Console  Logging 

The  following  command  line  starts  console  logging: 

>  SET  /COLOG-ON 

When  you  start  console  logging,  COT...  retains  the  current  console 
terminal  assignment.  If  you  have  just  bootstrapped  the  system, 
COT. ..  assigns  CO:  to  TTO : .  The  default  location  and  name  of  the  log 
is  LB :  [  1 , 4 ] CONSOLE . LOG .  COT.  •  •  always  creates  a  new  version  of 
the  default  log  file  when  you  start  console  logging. 


3.4.3  Stopping  Console  Logging 

The  following  command  line  stops  console  logging: 

> SET  /CO LOG-OFF 

When  you  stop  console  logging,  the  current  console  terminal  assignment 
is  retained.  Use  the  MCR  DEV  command  to  display  the  current  console 
terminal.  Section  3.5  discusses  how  you  can  use  the  MCR  DEV  command 
to  monitor  how  CO:  is  redirected. 
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NOTE 

Do  not  abort  COT....  Aborting  COT...  causes  severe 
pool  fragmentation. 


3.4.4  Disabling  the  Console  Terminal 

To  disable  the  console  terminal,  type  the  following  commands 

>  8  E  T  /GDI.  OG/NCtCr.  C0TERM3  3 

This  command  line  enables  you  to  maintain  a  log  file  of  system 
messages  without  using  a  terminal  as  the  console  terminal.  This  is 
especially  useful  if  your  system  does  not  have  many  terminals  or  if 
you  cannot  spare  a  terminal  to  dedicate  to  receiving  system  messages. 

When  you  do  this,  messages  starting  with  a  bell  still  come  out  on  the 
console  terminal  (i.e..  Device  not  ready).  To  completely  disable  COs 
(that  is,  to  stop  these  messages)  assign  COs  to  NLs. 

Once  you  have  disabled  the  console  terminal  with  the  NOCOTERM  option, 
the  following  command: 

>  SET  /COLOG/COTERM 

restores  the  most  recent  console  terminal  assignment. 


3.4.5  Reassigning  the  Console  Terminal 

The  following  command  line  reassigns  the  console  terminal: 

>SET  /CGLOG/COTC  CERM3  3  T  t>TTnn ♦ 3  3 

where  TTnn:  is  the  newly  assigned  console  terminal.  When  you 

bootstrap  your  system,  the  default  console  terminal  assignment  is 
TTO:.  When  you  start  console  logging,  the  default  console  terminal 
assignment  is  the  current  console  terminal. 


3.4.6  Disabling  the  Log  File 

To  disable  the  log  file,  type  the  following  command  line: 

>  SET  /COLOG/NOLOGFILE 

This  command  line  enables  you  to  continue  recording  system  messages 
time-stamped  by  COT...  at  the  console  terminal  without  recording  the 
messages  in  a  log  file. 


3.4.7  Reassigning  the  Log  File 

The  following  command  line  reassigns  the  log  file: 

>  SET  /C0L0G/L06CCFILE3C.  =  Cfilespec333 

where  "filespec"  is  any  legal  file  specification  as  described  in  the 
RSX— 11 M/M— PLUS  Utilities  Manual .  The  default  file  specification  is 
LB: [1,4] CONSOLE . LOG . 
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To  change  only  part  of  the  file  specification  for  the  log  file,  type 
only  that  part  of  the  file  specification  after  the  equal  sign  that  you 
want  to  change  from  the  default.  For  example,  if  LBs  is  DRO:  and 

you  want  to  make  the  log  file  DBO : [301 , 55 ] CONSOLE .LOG,  type  the 
following: 

> BET  /C0L0G/L0GFILE=DB0 J C301 f 553 

If  you  want  to  make  the  log  file  TESTLOG.LOG  in  the  default  UIC  on 
LB:,  type  the  following: 

>SET  /COLOG/ L.0GFILE  =  TESTL0G 

In  all  cases,  COT  fills  in  the  missing  parts  of  the  file  specification 
with  parts  from  the  default  file  specification,  LB: [1,4] CONSOLE. LOG, 
and  creates  a  new  version  of  the  log  file. 

To  create  a  new  version  of  the  current  log  file,  type  the  following: 

>SET  / C 0 L 0 G / L 0 G FILE := 

If  you  have  disabled  the  log  file  with  the  NOLOGFILE  option,  this 
command  line  restores  the  most  recent  log  file  assignment.  Although  a 
new  version  of  the  log  file  is  created,  the  rest  of  the  file 
specification  does  not  change. 

To  change  the  log  file  back  to  the  default,  type  the  following: 

>SET  /C0L0G/L0GFILE 

This  command  line  creates  and  opens  a  new  version  of  the  default  loq 
file. 


3.4.8  Using  Multiple  Console  Logging  Commands 

You  can  enter  multiple  console  logging  commands  in  a  command  line. 
The  following  command  line:  starts  console  logging,  assigns  the 

console  terminal  to  TT17:,  and  opens  a  log  file  named  TESTLOG . TST  in 
the  default  UFD  on  LB: 

>SET  /C0L0G=0N/C0TERM=TT17*/L0GFILE=TESTL0G.TST 

The  following  command  line  disables  the  console  terminal  and  restores 
the  log  file  to  the  default: 

>SET  /C0LGG/N0C0TERM/L0GFILE 


3.5  MONITORING  THE  STATUS  OF  CO: 

To  use  the  MCR  DEV  command  to  determine  the  status  of  CO:,  while  the 
console  logger  is  active,  enter  the  following: 

>DEV  COt 

The  system  responds  as  follows: 

C00J  LOADED 

This  response  means  that  the  console  driver  (CODRV)  is  loaded  and  that 
COT..,  handles  system  messages  to  CO:. 
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Use  the  console  logging  display  option  to  display  the  console  terminal 
assignment  as  follows: 

> SET  /C0L..06 

If  you  have  disabled  console  logging,  use  the  MCR  DEV  command  to 
determine  the  terminal  assigned  as  CO:  as  follows: 

>DEV  cg: 

CGO:  TTnnt 

where  nn  is  the  terminal  to  which  the  CO:  pseudo  device  is 

redirected . 

Before  COT...  exits,  it  redirects  CO:  to  the  current  console 
terminal.  If  there  is  no  console  terminal  (because  you  disabled  it 
with  the  NOCOTERM  option)  when  you  stopped  console  logging,  then  CO: 
is  redirected  to  the  last  terminal  COT...  assigned  as  the  console 
terminal.  In  this  case,  the  terminal  driver  handles  messages  directed 
to  CO:  and  redirects  them  to  TTnn:. 

If  you  have  disabled  the  console  terminal  with  the  NOCOTERM  option  but 
continue  to  record  system  messages  to  CO:  in  a  log  file,  then  use  the 
MCR  DEV  command  to  determine  the  status  of  CO: 

>DEV  cg: 

COO:  LOADED 

This  response  means  that  the  console  driver  is  loaded  and  that 
COT...  handles  all  messages  directed  to  CO:;  however,  system  messages 
are  not  directed  to  a  terminal.  Use  the  display  option  to  verify  that 
CO:  is  not  assigned  to  a  terminal. 


3.6  REDIRECTING  CO: 

Use  the  MCR  REDIRECT  command  to  redirect  CO:  to  a  terminal,  only  when 
the  console  logger  is  not  active.  If  you  try  to  redirect  CO:  while 
the  console  logger  is  active,  you  will  receive  the  following  error 
message : 

>RED  --  Device  not  redirect able  \ 

For  example,  if  the  Console  Logger  is  active,  the  console  terminal  is 
assigned  to  TT2:,  and  you  stop  console  logging,  COT...  redirects  CO: 
to  TT2 :  before  exiting.  Use  the  MCR  DEV  command  to  verify  that  CO: 
is  redirected  to  TT2 : .  To  assign  the  console  terminal  to  TTO : ,  use 
the  MCR  REDIRECT  command  as  follows: 

>red  tto:=co: 

If  you  then  start  console  logging  again,  COT...  will  assign  TTO:  as 

the  console  terminal. 


NOTE 

Do  not  redirect  CO:  to  CO:. 
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3.7  READING  THE  LOG  FILE 

Because  the  current  log  file  is  open  for  writing  if  LOGFILE  is 
enabled ,  you  can  read  it  only  by  using  PIP  with  the  Shared  Read  (/SR) 
switch.  For  example,  if  the  log  file  is  DRO : [1 , 4]CONSOLE . LOG ,  and  you 
type  the  following: 

>PIP  Tlt^DROtCCl > 43  3 CONSOLE* L  OG 

PIP  responds  as  follows: 

PIP  Open  f  3  .i  1  u  r  e  o  n  i  n  put  file 
DR0tCl>43C0NS0LE*L0G>l  —  Accessed  for  write 

To  read  the  log  file,  type  the  following: 

>PTP  TI t^DROtC Cl r 433 CONSOLE ♦LQG/SR 

A  sample  log  file  follows: 


1 6  t  4  3  1 1 9 

L  OSEOUt 

user 

Cl  >43  T  T  5  3  t 

16 t 43 t 35 

L  o  r  1  i.  n 

u  ser 

ALPHA 

C  7  >  3  3  4 .1 

T  T  5  3 1 

16 t 45 t 07 

L  o  3  i  n 

u  ser 

BRAVO 

C 7  >  42 3  TT 1 3  t 

16 t 46 t 21 

***  DM0 

♦  _ 

d  i  s  in  o  u  n  t  c  o  in  p  1  e  t  e 

1 6  t  4  6 1  3  2 

L  o  $  i  n 

use  r 

DECNET 

C  2 4 0  >  2 4 0  3  TT30  t 

16  t  47  1 22 

L  o  <2  i  n 

u  s  e  r 

CHARLIE 

C  7  >  3  7  3  "J 

TT22  t 

16 t 47 t 38 

***  L.PO 

♦  _ 

not  ready 

16 t 47 t 49 

L  O  li  o  u  l 

u  s  e  r 

Cl  >41  TT53  t 

16 t 47 t 58 

L  O  3  0  u  t 

u  s  e  r 

C7  >  3733  T T 2 2  t 

16 t 48 t 01 

1...  o  <=s  i  n 

u  s  e  r 

ALPHA 

C7  >33411 

T  T  5  3  t 

16 t 49 t 40 

L  o  3  i  n 

user 

DECNET 

C  2  4  0  >  2  4  0 

3  HTOt 

3.8  SAMPLE  CONSOLE  LOGGING  TERMINAL  SESSION 

Following  is  an  annotated  example  which  shows  a  console  logging 
terminal  session  illustrating  how  you  use  all  the  commands  described 
in  the  Sections  3.4  through  3.7. 


Example  3-1  Sample  Console  Logging  Terminal  Session 
(This  example  assumes  that  LB:  is  assigned  to  DBO : . ) 


>8ET  /COLOG 
COT  ~~ 

C  o  n  s  o  1  e  ~  N  o  ri  e 
Lost  file  =  None 
DEV  COt 
COOt  TTOt 
>SET  /COLOG-ON 
>DE V  COt 
COOt  LOADED 
>SET  /COLOG 
COT  — 

Console  =  TTOOOt 

LoSfile  -  DBOOOtCCl»433CGNSGLE.L 0G>1 

>SET  /CQL0G/CQTERM-TT51 t 

>SFT  /COLOG/LOGFILE  =  DRt  CC301 » 553  3TEST 


o 

0 

0 

o 

0 

0 


(continued  on  next  page) 
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Example  3-1  (Cont.)  Sample  Console  Logging  Terminal  Session 


>SET  /COLOG 
COT  — 

Console  =  TT051! 

Loser ile  =*  DR000:cr.301>55  3  3TEST*L0GM 
>SET  /COLOG/NOCOT 
>SET  /CGLOG 
COT  -- 

Console  =  None 

LoSfile  =  DR000:CC301f5533TEST  ♦  I..GG>1 

>DEV  co: 

COO*  LOADED 

>SET  /COLOG/COTER/NOLOG 
>SET  /COLOG 
COT  . 

Console  *  TTOSlt 
L  o  S  f  i  1  e  -  N  o  ri  e  ♦ 

>SET  / C 0 L 0 G /COT F. R M =  T  T 1 7  ♦  / L 0 6  = 

>SET  /CO LOG 

cor 

Console  *  TT017t 

LoSfile  -  DROOO  JET.  301  >55  3  3  TEST  ♦LOG*  2 
>SET  /COLOG-OFF 
>SET  /COLOG 
cor  -- 

C o  n  s ole  ~  N  o n e 
L.  o  S  f  :i.  1  e  N  o  n  e 

>DEV  co: 
coo:  tti7: 

>R E D  TT5i:=C0: 

>DEV  co: 
coo:  TT5i: 

>SET  /CO LOG-ON  / L 0  G  -  D  B 1 :  C  C7  f  301. 3 1 

>SET  /COLOG 

COT 


© 
© 
© 

© 


© 

© 

*  (D 


C  o  n  s  o  1  e  :=:  T  T  0  5 1 : 

L  o  si  file  =  D  D  0  0 1 :  CC7f30133CGNS0LE  ♦L.QGf  1 
>SET  /COLOG/COT-TTO: /LOG 
>SET  /COLOG 

cor  — 

Console  -  TTOOO: 


© 


Loaifile  *  DBOOO:CC1f43DCONSOL.E*LOG52 
>P  I P  T I :  ~L  B:CC1f433CONSOLE*LQG 
P I P  -  -  0  p  e  n  f  a  i  1  u  r  e  o  n  i  n  p  u  t  f  :i  1  e 
DB0:CC-1f431C0NS0I..E*L0Gf3  —  Accessed 


>pip  t i : ^ i 

„B: CCl F433CONSOLE.LOG/SR 

16  M3:  .1.9 

L  o  S  o  u  t 

u  s  e  r 

CC1  f  43 3  TT 

53: 

16: 43 J 35 

Login 

u  s  e  r 

ALPHA 

r.  r.  7 

16:45:07 

L  o  S  i.  n 

u  s  e  r 

BRAOO 

C  C  7 

16: 46: 2i 

***  DM0 

♦ 

d  i  s  m  o  u  n  t  c 

o  iti  p  1  e  t  e 

1.6:46:32 

i...  o  S  i  n 

u  s  e  r 

DECNET 

r.  \:  2 

16:47:22. 

L.  o  S  i  ri 

u  s  e  r 

CHARI.  IF 

r.  c  7 

16: 47: 38 

***  LPO 

♦ _ 

n  o  t  r  e  a  d  y 

16: 47: 49 

L  o  S  o  u  t 

u  s  e  r 

CC1 f 43 3  TT 

53: 

16:47:58 

L  o  S  o  u  t 

u  s  e  r 

CC7f37333 

T  T  2  2  : 

16548:01 

L  o  S  i  n 

u  s  e  r 

ALPHA 

r:  r.  i 

1 6  :  4  9  5  4  0 

I..OS  i. n  user 

DECNET 

r.  r.  2 

f o  r  write 


334  3  3  T T 5 3 : 
4233  TT13: 


3  3 


13  TT30: 
T  T  2  2  : 


T  T  5  3  : 

13  hto: 


>3  E  T  / C 0  L  0 G  /  N  0 C  0  T  E  E  M  /  N 0 L  0  G 

COT  —  Not  loss ins  on  a  terminal 


o  r  1 1:)  a  f  i.  1  e  r  COT  e  x  i.  t  i  n  S 


>dev  co: 
coo:  tto: 


© 


© 
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O  Displays  the  current  console  terminal  (none)  and  log  file 
(none)  assignments,  indicating  that  the  Console  Logger  is 
not  active. 

0  Illustrates  the  MCR  DEV  command  that  shows  how  CO:  is 

redirected.  CO:  is  redirected  to  TTO : ,  which  means  that 

the  Console  Logger  is  not  active  and  that  the  terminal 
driver  redirects  CO:  to  TTO:. 

0  Starts  console  logging. 

0  Shows  that  the  Console  Logger  is  active  because  CODRV  is 
loaded.  The  display  option  shows  that  COT...  redirects  CO: 
to  TTO:  and  that  DBO : [1 , 4]C0NS0LE . LOG; 1  is  the  log  file. 
These  are  both  the  defaults  when  you  bootstrap  your  system. 

0  Shows  how  you  assign  the  console  terminal  to  TT51 : . 

0  Shows  how  you  assign  the  log  file  to  DR: [301 , 55 ]TEST.L0G. 
COT...  fills  in  the  missing  parts  of  the  file  specification 
with  parts  from  the  default  file  specification.  In  this 
case,  COT...  supplies  the  file  type. 

Q  Displays  the  current  console  terminal  (TT51:)  and  log  file 
(DR: [301 , 55 ]TEST . LOG; 1 )  assignments  resulting  from  command 
lines  5  and  6. 

0  Disables  the  console  terminal  and  retains  the  current  log 
file  ( DR: [301 , 55 ]TEST .LOG; 1 ) •  The  display  option  confirms 
this . 

0  Shows  that  when  you  disable  the  console  terminal  with  the 
NOCOTERM  option,  the  console  logger  is  still  active  (CODRV 
is  loaded),  but  CO:  is  not  redirected  to  any  terminal. 

0  Illustrates  the  multiple  commands  that  restore  the  most 
recent  console  terminal  assignment  (TT51:)  and  disable  the 
log  file.  The  display  option  confirms  this. 

0  Illustrates  the  multiple  commands  that  assign  the  console 
terminal  to  TT17:  and  restore  the  most  recent  log  file. 

The  display  option  confirms  these  assignments.  The  version 
number  of  the  log  file  is  incremented. 

0  Stops  console  logging.  The  display  option  confirms  that  the 
console  logger  is  not  active.  CO:  is  redirected  to  TT17:, 
which  was  the  last  console  terminal  assignment  before 
COT...  exited. 

©  Redirects  CO:  to  TT51 :  with  the  MCR  REDIRECT  command  and 
confirms  this  with  the  MCR  DEV  command. 

©  Illustrates  multiple  commands  on  a  command  line.  Starts 
console  logging,  retaining  the  current  console  terminal 
assignment  (TT51:)  redirected  with  the  MCR  REDIRECT  command 
in  step  13,  and  opening  a  log  file 

DB001 : [7 , 301 ] CONSOLE . LOG ; 1 .  The  display  option  confirms 

these  assignments. 

0  Illustrates  multiple  commands  on  a  command  line.  Assigns 
the  console  terminal  to  TTO:  and  restores  the  default  log 
file.  The  display  option  confirms  these  assignments.  The 
version  number  of  the  log  file  is  incremented. 
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0  Illustrates  what  happens  when  you  try  to  read  an  open  log 
file  without  the  Shared  Read  switch  (/SR). 

(fk  Shows  how  to  read  an  open  log  file  using  the  Shared  Read 

switch.  Each  message  in  the  log  file  begins  with  a  time 
stamp. 

0  Disables  the  console  terminal  and  the  log  file. 

COT...  exits  because  no  console  logging  is  in  progress. 
COT...  displays  a  message  informing  you  that  it  is  exiting. 
The  MCR  DEV  command  shows  that  CO:  is  redirected  to  TTO : , 
the  console  terminal  assignment  before  COT...  exited. 


3.9  ERROR  MESSAGES 

COT  —  LUN  assignment  to  console  terminal  failed 

Explanation:  You  specified  an  incorrect  terminal  number 

console  terminal. 

User  Action:  Use  the  COTERM  option  to  assign  the 
terminal  to  a  terminal  in  your  hardware  configuration. 

COT  —  Illegal  console  terminal 

Explanation:  You  tried  to  assign  a  device  that  is  off  line  or  is 

not  a  terminal  to  CO:. 

On  RSX-1 1M-PLUS  systems,  the  device  may  be  illegal  because  it  is 
a  spooled  terminal. 

User  Action:  Use  the  COTERM  option  to  assign  a  terminal  in  your 
hardware  configuration  to  CO: 

COT  —  Console  driver  not  loaded,  COT  exiting 

Explanation:  The  console  driver,  CODRV,  is  not  loaded. 

User  Action:  Load  the  console  driver  and  start  console  logging. 

COT  —  Maximum  consecutive  write  errors,  disabling  logfile 

Explanation:  An  error  occurred  on  five  consecutive  write 

operations  to  the  log  file.  COT. • •  closes  the  log  file  and 
disables  logging  to  the  log  file. 

User  Action:  Determine  the  problem  that  caused  the  write  errors 
and  correct  it.  Then  restart  COT... 

COT  —  Not  logging  on  a  terminal  or  to  a  file,  COT  exiting 

Explanation:  You  have  disabled  the  console  terminal  with  the 

NOCOTERM  option  and  the  log  file  with  the  N0L0GFILE  option. 

User  Action:  If  you  did  not  intend  to  stop  console  logging, 
start  it  again  specifying  either  a  log  file,  console  terminal,  or 
both . 


as  the 

console 
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COT  -  Unable  to  redirect  CO:  to  a  terminal  -  CO:  is  offline,  COT  exiting 

Explanation:  CO:  is  off  line.  There  is  a  problem  with  the  most 

recent  console  terminal  assignment.  It  may  be  off  line  or  not  a 
terminal . 

On  RSX-11M-PLUS  systems,  the  problem  may  be  that  a  spooled 
terminal  was  assigned. 

User  Action:  Start  COT...  and  specify  a  legal  console  terminal 
with  the  COTERM  option.  Then,  stop  console  logging. 

COT  —  Syntax  error 

Explanation:  You  made  an  error  in  entering  a  console  logging 

command . 

User  Action:  Check  the  command  description  in  Section  3.4,  and 
enter  the  command  correctly. 

COT  —  Will  attempt  console  LUN  assignment  to  TTnn : 

Explanation:  This  error  message  may  occur  when  you  stop  console 

logging.  If  COT...  cannot  redirect  the  console  terminal  to  the 
terminal  currently  assigned  as  the  console  terminal,  it  tries  to 
redirect  CO:  to  the  previous  console  terminal  assignment.  If 

that  fails,  it  tries  TTO: •  If  that  fails,  it  generates  the  error 
message : 

$COT  —  LUN  assignment  to  console  terminal  failed 

User  Action:  Start  console  logging  again,  specifying  a  legal 
console  terminal.  Then  stop  console  logging. 

COT  Illegal  command  —  Console  logging  has  not  been  turned  on 

Explanation:  You  issued  a  console  logging  command  before 

starting  console  logging. 

User  Action:  Start  console  logging  and  issue  the  command. 

COT  —  Logfile  x  error 

filespec  —  QIO  Error  Code  -nn. 

Explanation:  An  I/O  error  occurred  while  COT...  was  performing 

an  operation  on  the  log  file.  The  function  being  performed,  x, 
is  WRITE,  OPEN,  or  CLOSE.  The  filespec  is  any  legal  filespec 
designated  for  the  log  file.  The  error  code,  -nn . ,  is  an  I/O 
error  code . 

User  Action:  Look  up  the  I/O  Error  Code  in  the  RSX-11M/M-PLUS 
and  Micro/RSX  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 
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CHAPTER  4 


THE  I/O  EXERCISER  <IOX) 


The  I/O  Exerciser  (IOX)  detects  and  diagnoses  I/O  problems  on  the 
disk,  terminal,  and  tape  units  in  your  hardware  configuration.  Using 
the  IOX  Command  Language,  you  can  execute,,  control,  and  monitor  I/O 
exercises  on  device  units  that  you  specify  for  exercising. 

This  chapter  has  a  narrative  part  and  a  reference  part.  The  narrative 
part  presents  the  information  you  need  to  run  the  I/O  Exerciser  in  the 
order  you  need  that  information.  The  reference  part  describes  each 
command  in  the  IOX  Command  Language . 


4 . 1  INTRODUCTION 

This  section  serves  the  following  functions : 

•  Provides  an  overview  of  the  steps  involved  in  running  an  I/O 
exercise 

•  Describes  how  the  I/O  Exerciser  exercises  different  types  of 
devices 

•  Distinguishes  between  file-structured  and  non— file— structured 
volumes 

•  Categorizes  the  IOX  commands  by  function 


4.1.1  Running  an  I/O  Exercise 

Before  you  run  an  I/O  exercise,  you  need  to  consider  the  following: 

•  Kinds  of  devices  to  exercise  (magnetic  tapes,  cassettes, 
disks,  terminals,  and  DECtapes) 

•  Kind  of  exercises  to  run  for  each  device  (IOX  has  three  kinds 
of  exercises) 

•  Exercise  parameters  to  set  for  each  exercise  (such  as  whether 
or  not  to  test  random  blocks  on  disks,  how  many  records  to 
test  on  magnetic  tapes,  and  how  long  to  run  the  exercise) 

The  steps  involved  in  running  an  I/O  exercise  include  your  making 
decisions  about  these  three  aspects  of  testing.  Using  the  IOX  Command 
Language,  you  implement  these  decisions  and  run  an  exercise. 
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To  run  an  I/O  exercise,  you  must  take  the  following  basic  steps: 


1. 

Invoke  IOX. 

2. 

Determine  which  devices  you  want  to  test  and  include  them 
your  "test  configuration." 

in 

3. 

Determine  the  kind  of  exercise 
test  configuration. 

to  run  on  each  unit 

in  your 

4. 

Set  exercise  parameters  to  affect  how  IOX  tests  the 
want  to  exercise. 

units 

you 

5. 

Begin  the  exercise  and  possibly 
change  steps  2,  3,  and  4. 

interrupt  the  exercise 

to 

6. 

Monitor  the  activity  and  error 
during  an  exercise. 

reports  that  IOX 

generates 

7. 

Exit  IOX  or  repeat  this  process 
5,  as  appropriate. 

beginning  at  step  2, 

3.  4, 

or 

4.1.2  How  IOX  Exercises  Different  Types  of  Devices 

IOX  performs  exercising  on  disks,  magnetic  tapes,  cassettes, 
terminals,  and  DECtapes .  You  can  use  IOX  to  perform  an  exercise 
operation  on  any  mounted  volume  disk,  magnetic  tape  unit,  or  terminal 
in  your  hardware  configuration  that  has  not  been  allocated  to  another 
user.  By  default,  IOX  can  exercise  28  units  simultaneously.  You  can 
edit  the  task  build  command  file  (see  Section  4.11)  to  enable  IOX  to 
test  as  many  as  250  units  simultaneously. 

In  general,  i/o  exercises  consist  of  four  steps: 

1.  Writing  bytes  of  data  (made  up  of  a  specific  data  pattern)  to 
a  mounted  volume 

2.  Reading  the  data  just  written 

3 •  Checking  that  the  data  read  matches  the  data  written 
4.  Reporting  mismatches  of  data 
IOX  repeats  this  process  until  the  exercise  has  completed. 


4. 1.2.1  How  IOX  Exercises  Disks  -  IOX  writes  a  buffer  of  data  to  a 
disk  and  then  reads  that  data  from  the  disk.  You  can  also  set 
exercise  parameters  that  determine  the  following: 

•  The  data  pattern  to  be  written 

•  The  range  of  blocks  to  be  tested 

•  Whether  to  test  blocks  sequentially  or  randomly 


4. 1.2. 2  How  IOX  Exercises  Magnetic  Tapes  and  Cassettes  -  IOX  uses  the 
same  algorithm  to  exercise  magnetic  tapes  and  cassettes.  IOX  rewinds 
the  tape,  writes  one  record,  space  reverses  one  record,  and  then  reads 
the  record  that  was  just  written.  This  procedure  is  repeated  until 
the  number  of  records  that  you  specified  for  testing  are  read.  At  the 
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end  of  the  exercise,  IOX  writes  two  tape  marks  and  rewinds  the  tape. 
If  you  are  testing  more  than  one  unit,  IOX  continues  testing  on  those 
units  while  the  tape  is  rewinding.  You  can  also  set  exercise 
parameters  that  determine  the  following: 

•  The  data  pattern  to  be  written 

•  The  size  of  the  data  buffer 

•  The  number  of  records  to  be  exercised 


4. 1.2. 3  How  IOX  Exercises  Terminals  -  IOX  exercises  terminals  by 
continuously  writing  out  a  portion  of  the  ASCII  character  set  to  a 
terminal  that  is  not  logged-in.  If  LOOPBACK  NO  (the  default)  is 
specified,  this  is  all  that  happens.  If  LOOPBACK  is  specified,  IOX 
will  read  the  characters  back  after  writing  them,  compare  the  two  sets 
of  characters,  and  report  on  the  comparison  between  the  two  sets. 
(LOOPBACK  mode  requires  that  a  loopback  connector  be  connected  in 
place  of  the  terminal  to  direct  the  characters  written  back  to  IOX. 
IOX  depends  on  the  presence  of  a  typeahead  buffer  to  store  the 
characters  between  writing  and  reading  them.  See  Section  4.4  for 
further  information  on  the  LOOPBACK  parameter.) 


4. 1.2. 4  How  IOX  Exercises  DECtapes  -  IOX  exercises  DECtapes  by 
writing  forward/ reading  forward,  then  writing  reverse/reading  reverse 
until  the  end  of  the  tape  is  reached.  IOX  exercises  DECtapes  using  a 
data  buffer  of  two  blocks  ( 1024 (decimal )  bytes).  You  can  set  a  test 
parameter  only  to  determine  the  data  pattern  that  IOX  writes  to  the 
DECtape . 


4. 1.2. 5  Non-File-Structured  and  File-Structured  Volumes  -  IOX  exer¬ 
cises  devices  on  two  kinds  of  volumes:  non-file— structured  (NFS)  and 
file-structured  (Files-11).  The  meanings  of  these  terms  may  differ 
slightly  from  other  manuals  within  the  RSX-11M/M-PLUS  set.  In  the 
context  of  the  I/O  Exerciser,  they  are  defined  as  follows:  all  tapes 
and  terminals  are  NFS  volumes.  (Throughout  this  chapter,  the  term 
"NFS"  describes  devices  and  the  testing  of  devices  that  contain 
non-file-structured  volumes.)  Disks  can  be  either  NFS  or  Files-11 
volumes.  Files-11  volumes  are  only  those  disks  that  have  been 
initialized  with  the  MCR  INITIALIZE  command  and  therefore  have  a  home 
block  and  a  Files-11  structure. 


4.1.3  The  Four  Categories  of  IOX  Commands 

The  IOX  Command  Language  has  four  categories  of  commands: 

1.  Function  Commands  -  Select  devices  for  testing,  deselect 
devices  from  testing,  and  initiate  tasks  to  run  in  parallel 
with  IOX. 

2.  Control  Commands  -  Start  and  stop  IOX  processing,  switch  IOX 
modes  of  operation,  and  exit  from  IOX  to  the  operating  system 
monitor . 

3.  Display  Commands  -  Display  current  default  parameters,  get 
help  text  for  IOX  commands,  and  display  status  and  activity 
reports  during  an  I/O  exercise. 
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4.  Parameter  Commands  -  Set  default  parameters  that  affect  how 
IOX  tests  the  devices  you  select  for  testing. 

Table  4-1  lists  the  IOX  commands  under  their  appropriate  categories. 


Table  4-1 

Four  Categories  of  IOX  Commands 


Function  Control  Display  Parameter 


DESELECT 

EXECUTE 

FILES11 

SELECT 

VERIFY 


LOOPBACK 

PATTERN^ 

RANDOM 

RANGE  1 

RECORDS 

REPORTERRORS 

RETRIES 

RUNTIME 

SUMMARYTIME 

TEMPORARYFILE 

VOLUMECHECK 

WAIT 

WRITECHECK 


ABORT 

CTRL/C 

EXIT 

PROCEED 

RESTART 

START 


BADBLOCKS 1 
CONFIGURE  1 
DENSITY  1 
HELP 

PARAMETERLIST 
PATTERN  1 
PRINTSUMMARY 


BADBLOCKS 1 

BUFFERSIZE 

COMPAREDATA 

CONFIGURE  1 

CONTROL__C 

DENSITY  1 

ERRORLIMIT 

INTERLEAVE 

LOGFILE 


1.  These  commands  have  two  forms:  one  that  displays  the 
current  default  for  the  parameter  and  one  that  sets  the 
current  default  for  the  parameter. 


4.2  INSTALLING  AND  INVOKING  IOX 

IOX  is  task  built  as  a  nonprivileged ,  checkpointable  task  that  runs  at 
a  priority  of  50  in  the  GEN  partition.  You  can  run  IOX  by  entering 
the  RUN  command  from  either  MCR  or  DCL  or  by  installing  and  invoking 
IOX. 


4.2.1  Installing  IOX 

Install  IOX  from  a  privileged  terminal  with  the  MCR  or  DCL  INSTALL 
command . 

For  RSX-11M  systems  that  do  not  support  the  Extend  Task  Directive  (see 
the  RSX-11M/M-PLUS  and  Micro/RSX  Executive  Reference  Manual) ,  install 
IOX  with  an  increment  large  enough  to  accommodate  all  buffers. 
Assuming  all  initial  IOX  defaults,  allocate  600 (decimal)  words  per 
unit  to  be  tested  simultaneously.  For  example,  to  test  three  devices 
simultaneously,  install  IOX  as  follows: 

>INS  $I0X/INf>1800* 
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For  RSX-11M  systems  that  support  the  Extend  Task  Directive,  install 
IOX  without  an  increment. 

For  RSX-11M-PLUS  systems,  install  IOX  by  typing  the  following: 

>1  NS  f IOX 


4.2.2  Invoking  IOX 

You  can  invoke  IOX  from  any  terminal . 

On  RSX-11M  single  user  systems,  mount  all  disks  that  you  want  to 
exercise  as  file-structured  disks.  If  you  have  a  multiuser  system, 
first  allocate  all  units  that  you  want  to  exercise.  Then  mount  only 
those  disks  that  you  want  to  exercise  as  file-structured  disks. 

On  RSX— 1 1M-PLUS  systems,  allocate  and  mount  all  units  that  you  want  to 
exercise.  Mount  non-file-structured  volumes  using  the  /FOREIGN  switch 
for  the  MOUNT  command . 


4. 2. 2.1  Invoking  an  Installed  Version  of  IOX  -  If  IOX  is  installed, 
invoke  it  with  the  following  command: 

>IOX 
1 0X> 

IOX  responds  by  prompting  you  with  the  name  of  the  task  that  you 
assigned  to  IOX  when  you  installed  it.  If  you  did  not  specify  a  task 
name  when  you  installed  IOX,  its  task  name  is  ...IOX.  After  receiving 
the  prompt,  you  can  enter  IOX  commands. 


4. 2.2.2  Invoking  IOX  When  It  Is  Not  Installed  -  If  IOX  is  not 
installed,  invoke  it  by  entering  the  RUN  command  from  either  MCR  or 
DCL.  In  this  case,  IOX  uses  your  terminal  number  to  name  the  task  and 
prompts  you  using  this  task  name.  For  example,  if  from  TT10:  you 
type  the  following: 

>RUN  *IOX 

When  you  receive  the  following  prompt,  you  can  enter  IOX  commands: 

TT  10> 

For  RSX-11M  systems,  if  your  system  does  not  support  the  Extend  Task 
Directive,  then  run  the  I/O  Exerciser  with  an  increment  large  enough 
to  accommodate  all  buffers.  Assuming  all  initial  IOX  defaults, 
allocate  600 (decimal)  words  per  device  to  be  tested  simultaneously. 
For  example,  to  test  four  devices  simultaneously,  invoke  IOX  as 
follows : 

:  RUN  $1 OX/IN C«2400* 

When  you  invoke  an  uninstalled  version  of  IOX  on  RSX-11M  systems  that 
support  the  Extend  Task  Directive,  you  do  not  need  to  run  the  task 
with  an  increment . 

When  you  invoke  an  uninstalled  version  of  IOX  on  RSX-11M-PLUS  systems, 
you  do  not  need  to  run  the  task  with  an  increment. 
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4.3  USING  INDIRECT  COMMAND  FILES  WITH  IOX 


You  can  use  indirect  command  files  as  input  to  IOX.  IOX  accepts  one 
level  of  indirect  command  files.  You  can  use  indirect  command  files 
to  set  up  your  test  configuration,  choose  devices  for  testing,  set 
exercise  parameters,  and  start  and  exit  the  exercise.  You  cannot 
interrupt  an  I/O  exercise  to  enter  IOX  commands  from  an  indirect 
command  file.  The  default  file  type  is  "CMD." 


For  example,  use  an  editor  to  create  a  file  named  TEST . CMD  that 
contains  the  following  IOX  command  sequence: 

CONFIGURE  DB2:  7  Adds  DB2 :  to  the  test  configuration 


FILES11  DB2 : 


Chooses  DB2 :  for  an  exercise  that  preserves 
the  contents  and  structure  of  the  disk 


RUNTIME  10 


Sets  an  exercise  parameter  that  runs 
for  10  minutes 


START 

EXIT 


Starts  the  exercise 

Exits  from  IOX  to  the  operating  system 
monitor  when  the  exercise  completes 


After  you  invoke  IOX,  type  the  following: 

1 0  X  >1?  TEST 

IOX  exercises  DB2 :  (preserving  its  contents  and  structure)  for  10 
minutes  and  then  exits  to  the  operating  system  monitor. 


4.4  SETTING  UP  A  TEST  CONFIGURATION 


Before  you  can  exercise  a  unit,  you  must  first  include  it  in  your  test 
configuration.  When  you  include  a  unit  in  your  test  configuration, 
IOX  adds  the  unit  to  its  list  of  units  available  for  exercising  and 
creates  an  empty  data  structure  for  the  unit.  IOX  includes  in  the 
default  test  configuration  one  of  each  device  type  supported  by 
DIGITAL  as  unit  "0M . 


To  add  units  to  the  test  configuration,  you 
The  syntax  for  this  command  is  as  follows: 


use  the  CONFIGURE  command. 


CONFIGURE  [ddnn : [=type] ]  _ 


where : 

dd  The  device  mnemonic 


nn  The  device  number 

type  The  device  type,  either  DISK,  TERM,  or  TAPE 

You  can  add  any  unit  to  the  test  configuration  and  assign 
device  name  to  it  by  using  the  MCR  ASN  (ASSIGN)  command. 


a  logical 
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The  CONFIGURE  command  with  no  arguments  displays  the  current  test 


configuration . 

IGX>CONFIC 

For 

SURE 

example : 

hi  s  k  s  t 

DBO  DBO 

D  X  0  BYO 

UFO 
£  M  0 

DKO  DIO 
SYO 

DM0 

D  P  0 

Tapes  4* 

CTO  DTO 

MFC 

MMO  MSO 

M  T  0 

MUO 

Te  mi  in a Is 
1  TO 

* 

To  add  DK1 :  and  MM1 :  to  your  configuration,  type  tne  following: 


1 0  X  >C  0  N  F I G  U  R  F  D  K 1  i  M  H 1 1 


This  command  line  adds  DK1 : 
(because  DKO :  is  already 

configuration  as  a  tape  unit 
magnetic  tape) .  Section 
detail . 


to  the  configuration  as  a  disk  unit 
configured  as  a  disk)  and  MM1 :  to  the 
(because  MMO :  is  already  configured  as  a 
4.12  describes  the  CONFIGURE  command  in 


To  add  TT12 :  to  your  configuration,  types 


1 0X>C0N FIGURE  IT  1.2  X 


This  command  line  adds  TT12:  to  the  configuration  as  a  terminal  unit 
(because  TTO:  is  already  configured  as  a  terminal.)  If  you  wan  o 

exercise  your  terminal  using  LOOPBACK  mode,  the  following  termina 
characteristics  must  be  set  BEFORE  installing  the  LOOPBACK  connector: 
SLAVE,  PASSTHRU,  NOECHO,  LOWERCASE,  and  NOWRAP.  The  line  must  also  be 
logged  out. 


For  Loopback  mode,  IOX  relies  on  the  typeahead  buffer  to 
characters  it  writes  before  reading  them.  For  this  reason, 
the  number  of  characters  it  writes  to  the  size  of  the 
buffer,  and  does  not  operate  if  typeahead  is  disabled. 


store  the 
IOX  limits 
typeahead 


4 . 5  SELECTING  DEVICES  FOR  EXERCISING 

After  configuring  all  the  units  you  want  to  exercise,  you  select  units 
for  exercising.  When  you  select  a  unit,  IOX  fills  in  the  data 
structure  created  when  you  configured  the  unit.  This  data  structure 
contains  all  the  information  IOX  needs  to  exercise  the  specified  unit. 
You  select  units  for  exercising  with  the  FILES11,  SELECT,  and  VERIFY 
commands.  These  commands  require  device  and  unit  specifications 
within  their  command  lines. 


4.5.1  The  FILES11  Command 

The  FILES11  command  selects  a  disk  unit  with  a  mounted  Files-11  volume 
for  an  I/O  exercise.  Exercising  with  FILES11  does  not  affect  the 
contents  of  the  disk  being  tested. 
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4.5.2  The  SELECT  Command 

The  SELECT  command  selects  a  unit  with  an  NFS  volume  for  an  I/O 
exercise.  Invoking  the  exercising  function  by  using  the  SELECT 
command  will  destroy  the  contents  of  the  volume  being  exercised.  The 
SELECT  command  is  also  used  to  select  a  terminal  for  exercising. 


4.5.3  The  VERIFY  Command 

The  VERIFY  command  selects  a  disk  unit  with  a  mounted  NFS  volume  for 
an  I/O  exercise.  VERIFY  does  not  write  on  the  volume  being  exercised. 
Exercising  with  VERIFY  does  not  affect  the  contents  of  the  volume 
being  exercised  because  VERIFY  only  reads  from  the  volume. 


4.6  EXERCISE  PARAMETERS 

You  set  parameters  that  determine  how  IOX  exercises  units.  These 
exercise  parameters  determine  aspects  of  testing  such  as  how  long  an 
exercise  is  to  run,  how  many  records  are  tested  on  magnetic  tapes, 
what  range  of  blocks  are  tested  on  disks,  and  whether  output  is 
directed  to  your  terminal  or  to  a  log  file.  There  are  two  kinds  of 
exercise  parameters:  general  and  device  dependent. 


4.6.1  General  Exercise  Parameters 

The  following  commands  set  general  exercise  parameters  and,  therefore, 
affect  all  IOX  testing: 

CONFIGURE 

CONTROL__C 

LOGFILE 

PATTERN 

REPORTERRORS 

RUNTIME 

SUMMARYTIME 


4.6.2  Device-Dependent  Exercise  Parameters 

You  use  the  commands  listed  in  this  section  to  set  default  parameters 
for  the  units  that  you  select  for  exercising.  You  can  include  these 
commands  within  the  FILES11,  SELECT,  and  VERIFY  command  lines  to 
override  the  default  parameter  for  the  specified  unit. 


4. 6. 2.1  Parameter  Commands  for  Files-11  Disks  with  FILES11  -  The 
following  commands  affect  the  exercising  of  disks  that  you  select  with 
the  FILES11  command: 

COMPAREDATA 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

TEMPO RARYFILE 
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You  can  use  these  commands  to  set  the  default  parameters  before  you 
use  the  FILES11  command  to  select  a  unit.  You  can  also  use  these 
commands  within  the  FILES11  command  line  to  override  the  default 
parameters  for  the  unit  being  selected. 


4.6.2. 2  Parameter  Commands  for  NFS  Volumes  or  Terminals  with  SELECT  - 
The  following  commands  affect  the  exercising  of  NFS  volumes  or 
terminals  that  you  select  with  the  SELECT  command: 


BADBLOCKS 

BUFFERSIZE 

COMPAREDATA 

DENSITY 

ERRORLIMIT 

INTERLEAVE 

LOOPBACK 


RANDOM 

RANGE 

RECORDS 

RETRIES 

VOLUMECHECK 

WRITECHECK 


You  use  these  commands  in  conjunction  with  the  SELECT  command  to  set 
default  parameters  for  exercising  a  terminal  or  a  unit  with  an  NFS 
volume.  You  can  use  all  but  BADBLOCKS  within  the  SELECT  command  line 
to  override  the  current  default  settings  for  the  device  being 
selected . 

Table  4-2  lists  the  parameters  for  exercising  different  types  of 
devices . 


Table  4-2 

Parameter  Commands  by  Device  Type  for  SELECT 


NFS  Disks 

Cassettes 

DECtapes 

Magnetic 

Tapes 

Terminals 

BADBLOCKS 1 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

VOLUMECHECK 

WRITECHECK 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

RECORDS 

COMPAREDATA 

ERRORLIMIT 

BUFFERSIZE 

ERRORLIMIT 

DENSITY 

RECORDS 

RETRIES 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

LOOPBACK 

1 .  Cannot  be 

used  within 

SELECT  command  line . 

4. 6. 2. 3  Parameter  Commands  for  NFS  Volumes  with  VERIFY  -  The 
following  commands  affect  the  exercising  of  NFS  disks  that  you  select 
with  the  VERIFY  command: 

BADBLOCKS 

BUFFERSIZE 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 
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You  use  these  commands  with  the  VERIFY  command  to  set  default 
parameters  for  testing  a  unit  with  an  NFS  disk.  You  can  use  all  but 
BADBLOCKS  within  the  VERIFY  command  line. 


4.7  SETTING  PARAMETERS  FOR  EXERCISING  FILES-11  VOLUMES 

This  section  shows  you  how  to  use  IOX  to  exercise  an  RL02  with  a 
Files-11  structure.  Example  4-1  uses  the  following  IOX  commands: 

PARAMETERLIST 

Displays  current  default  parameters,  IOX  buffer  space  statistics, 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing . 

RUNTIME 

Sets  the  length  of  time  (in  minutes)  that  IOX  exercises  the 
unit(s)  you  have  selected  for  testing. 

FILES11 

Selects  a  disk  with  a  mounted  Files-11  volume  for  an  I/O  exercise 
that  preserves  the  contents  and  structure  of  the  disk. 

TEMPO RARYFILE 

Sets  the  size  of  the  temporary  file  that  IOX  uses  for  testing 
Files-11  disks  with  the  FILES11  command. 


START 


Starts  exercising  units  that  you  have  selected  for  testing. 


Example  4-1 


Exercising  an  RL02  with  the  FILES11  Command 


>AL.L  DL.0J 

o 

>MQU  DLOJ  LOUIE 

0 

>I0X 

0 

1 0 X  > P  A R  A H E T E R LIS T 

BUFFERS I ZE*  1024, 

COMPARFBATA*  YES 

ERROR!...  I  MIT-  1.0, 

CONTROL  ,.C-  YES 

INTERLEAVE-  4, 

LOOP ILF-  NO 

PATTERN-  0, 

LOOPBACK-  NO 

RECORDS*  1024, 

RANDOM-  YES 

RUNTIME*  5,  © 

REPORT ERRORS-  YES 

SUMMARY! IME*  1, 

RETRIES*  YES 

TEMPQRARYFILE*  500,  © 

VOLUME CHECK*  YES 
WAIT*  YES 
WRITECHECK*  NO 

o 


Buffer  space  U58^=  3290  ♦  :  1.924,  i  1.924  ♦  :  1  ♦ 

IOX >R UNTIME  3  0 

I0X>FILESU  DLO:  TEMP*800  0 

1 0  X  >P  A  R  A  M  E  T  F  R 


(continued  on  next  page) 
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Example  4-1  (Cont.)  Exercising  an  RL02  with  the  FILES11  Command 

Device  Mode  Buffersire  Filesize/Records/Ransie  Parameters 

D L 0 1  F 1 1  512  *  800.  ©  COM  RFT  RAM  FRR=-10 


O 


BUFFERS  I Z n>  1.024  v 
ERROR LIMIT*  10* 
INTERLEAVE-  4, 
PATTERN*  0* 
RECORDS-  1.024* 
RUNTIME*  3* 
SUMMARY! I ME*  1* 
TEMPORARY FILE *500* 


C 0 M P A R E D A T A ~  YES 

CONTROL . O  YES 

L OOF  I  I..E-  NO 
LOOPBACK*  NO 
RANDOM-  YES 

©  REPORT ERRORS-  YES 

RETRIES*  YES 

©  VQLUMECHFCK*  YFS 

WAIT*  YES 
14 R I TE CHECK*  NO 


B  j  f  f  e  r  %  p  a  e  e  <  i  s  a  <3  t ?  -  3  2  90*  t  1. 3 0  S  *  -t  1. 3  0  S  ♦  1 1  * 
I0X> START  0 


The  command  sequence  in  Example  4-1  does  the  following: 

O  Allocates  drive  DLO : . 

©  Mounts  the  disk  with  label  "LOUIE"  in  DLO:. 

©  Invokes  an  installed  version  of  IOX  with  default  task  name, 
. . .IOX. 

©  Displays  the  initial  default  parameters  with  PARAMETERLIST . 

©  Changes  the  default  RUNTIME  to  3  minutes. 

©  Selects  DLO:  for  FILES11  testing  with  a  temporary  file  size 
of  800  blocks. 

Note  the  difference  between  the  defaults  displayed  by  the 

PARAMETERLIST  command  before  and  after  you  changed  RUNTIME  and 
selected  DLO:. 

©  Only  the  RUNTIME  default  has  changed. 

©  The  default  for  TEMPORARYFILE  has  not  changed. 

©  After  you  selected  DLO:  for  testing,  PARAMETERLIST  contains 
an  extra  line  at  the  beginning  that  displays  all 

device-dependent  parameters  for  the  selected  device.  Each 
selected  device  has  its  own  display  line.  There  are  five 
fields  of  parameters . 

©  Field  four  shows  that  the  temporary  file  size  used  for 

FILES11  testing  for  DLO:  is  800 (decimal)  blocks  instead  of 
the  500 (decimal)  block  initial  default.  During  FILES11 
testing,  this  field  refers  only  to  temporary  file  size. 

©  The  START  command  begins  FILES11  testing  on  DLO:  for  a 

RUNTIME  of  3  minutes  and  uses  a  temporary  file  size  of 
800 ( decimal )  blocks . 
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4.8  SETTING  PARAMETERS  FOR  EXERCISING  NFS  VOLUMES 

This  section  shows  examples  for  the  command  sequences  that  test  a 
magnetic  tape  volume  using  the  SELECT  command  and  an  NFS  disk  using 
the  VERIFY  command.  Both  examples  are  explained  in  detail. 


4.8.1  Exercising  a  Magnetic  Tape  with  the  SELECT  Command 

The  command  sequence  in  Example  4-2  tests  a  magnetic  tape  by  using  a 
buffer  of  8K  bytes  (which  contains  the  data  pattern  052652)  to 

transfer  data. 

% 

Example  4-2  illustrates  the  following  commands: 

PARAMETERLIST 

Displays  current  default  parameters,  IOX  buffer  space  statistics, 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing . 

PATTERN 

Sets  the  pattern  that  IOX  writes  and  reads  during  an  exercise. 
BUFFERSIZE 

Sets  the  amount  of  data  that  IOX  transfers  for  every  read  or 
write  request  when  testing  NFS  disks,  magnetic  tapes,  and 
cassettes . 

DENSITY 

Sets  the  density  and  characteristic  word  of  the  specified 
magnetic  tape  or  displays  the  current  density  and  characteristic 
word  for  the  specified  magnetic  tape  unit. 

SELECT 

Selects  a  unit  with  a  mounted  NFS  scratch  volume  for  an  I/O 
exercise  that  destroys  the  contents  of  the  volume 

RETRIES 

Determines  (for  magnetic  tapes  and  NFS  disks)  whether  an  I/O 
driver  repeats  an  I/O  operation  after  the  driver  receives  errors 
during  the  operation. 

ERRORLIMIT 

Sets  the  maximum  number  of  errors  that  IOX  tolerates  between 
interval  reports  before  terminating  testing  on  a  device. 

RECORDS 

Specifies  the  number  of  records  to  be  exercised  on  magnetic  tapes 
and  cassettes. 


START 

Starts  exercising  units  that  you  have  selected  for  testing. 
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EXIT 


Terminates  IOX  processing  and  exits  from  IOX. 


Example  4-2  Exercising  a  Magnetic  Tape  with  the  SELECT  Command 


> ALL  MMOt  1 

> MOU  MMOt 

>  1 0  X  J 

IOX>PARAMFTERL 1ST 

BUFFF.RSI7E*  1.024* 

© 

COMPARED AT  A*  YES 

ERRORL.IMIT*  10* 

CONTROL  „..C*  YFS 

INTERLEAVE*  4* 

LOO FILE*  NO 

PATTERN*  0* 

© 

LOOPBACK*  NO 

RECORDS*  1.024* 

RANDOM*  YES 

RUNTIME*  5* 

RFPORTFRRORS*  YFS 

SUMhARYTIME*  1  * 

RETRIES*  YES 

TEMPORARYFILE*  500* 

MOL  UMF CHECK*  YFS 
WAIT*  YES 
WRITECHFCK*  NO 

© 


B u i f  e  r  s p a e o  usa S e 3 2 90*  *19 2 4  *  *  1 9 2 A  ♦  ♦ 1  * 


I'0X>  PATTERN  12  © 

IQX>BUFFFE  8192  O 

I0X>»FN8  MMOt 

Densitn*  1 400  BF’T  Characteristic  Word®  004004  (octal.) 

IQX>SFL  ECT  MMOt  RFTR I F8-N0  riFNSITY=800  FRR0R=10G  RFC  -20000 
I0X>PARAM 


0 e v  i  c e  M o d e  B u f  f  e r s ize  F  :i.  1  e s i  z e / R e c o r d s/Rsnsie  P a r a m e t e r s 


MM0J  NFS  81,92.  © 


20000.  ©  COM  FRR-10 ♦  © 


BUFFERS  1 7. E*  SI.  9  2  ♦ 
ERROR!...!  MI  T*  10* 

IN TER LEAVE*  4  * 
PATTERN  *  12* 
RECORDS*  1.024* 
RUNTIME*  5* 
SUMMARYTIME*  1* 
TEMPORARY FILE*  500* 


© 

© 


COMPARE DATA*  YES 

C0NTR01 . C*  YFS 

LOO FILE*  NO 
LOOPBACK*  NO 
RANDOM*  YES 
REP OR TERRORS*  YFS 
RETRIES*  YES 
VOL UMF CHECK*  YFS 
WAIT*  YES 
WRITE CHECK*  NO 


© 


B  u  f  f  >"•  r  s  p  a  c  e  « .i  <:>  a <3  e *  3  6  0  5  8  ♦  ♦  S 1  S  8  *  *  1. 8  292*  t  3  * 


I  OX > DENSITY  MMOt 

D e n s  :i  t y *  8 0 0  B P 1  C h a  r  a c  t  p  r  :i.  s  b  ;i  c  Wo  r d *  0 0000 0  (  o c  t  a  3  )  > 

I0X> START  © 

I U  X  -  -  M  M  0  *  b  a  d  b  1  o  e  k  ?  1 1  2  <  d  e  e  :i  iv;  a  1  )  1  6  0  (  o  c  t  a  3  > 


1 0 X  - -  S v:  !?i m a  i' y  o f  e x e r  c i «> e  r  a c t  i  v  i.  t y  at  2 0 -  J U L - 8 5  16*  5 0  t  4  0 

T I M  F  -  ~  R  u  i”,  t  1  tvt  :i.  n  ♦  F!  3  a  p  s  e  d  ♦  1  m  :i.  n  ♦  R  p  m  a  i  n  :i  ri  a  *  4  m  :i  n  ♦ 

M M 0  *  —  220  *  R /  W  r p a » .» e s  t •->  t o t a  l  i.  n <2  2 3 0  *  r e e o  r d s  w  i.  t h  1.  e  r  r a  r s 

A  S  T  s  e  V-  p  c  u  t  e  d  ♦  34  6  » 

I  d  l  e  -  3.  o  o  p  i.  b  e  r-  a  t  i.  o  n  s  t  3  4  4  * 


(continued  on  next  page) 
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Example  4-2  (Cont.)  Exercising  a  Magnetic  Tape  with  the  SELECT  Command 


IGX  —  MMO:  bad  block*  486  (decimal)  746  (octal) 

IOX  —  MHO:  bad  block*  551  (decimal)  1047  (octal) 

IOX  —  Summary  of  exerciser  activity  at  20-JUL.-85  16J54J50 
T I  ME  Runt  1  m  i  n  ♦  E 1  apse d  :  5  m  i  n  ♦  R e m a  i.  n  i  n l  0  m  i  n  * 

M  M  0  ♦  -  -  2  1 7  ♦  R  /  U  r  e  « u  e  a  t  s  t  o  t  a  1  :i.  n  3  21  7  ♦  records  w  :i  t  h  2  e  r  r  o  r  s 

A  S  T '  s  e  x  e  c »  j  t  e  d  :  325* 

3!  d  1  e  ~  1  o  o  p  :i.  t  e  r  a  t  :i  o  r  i  s  :  321* 

A  C  C  |J  M  U  L  A  T  E  D  T  0  T  A  L  S  : 


T I M F.  - R u n  t  5  m  i. r i  *  Flap s e d  ♦  5  iti  :i.  n  ♦  Re m a  i  n  i  n 3  :  0  m  :i.  n  * 

MMO:  ---  1  ? 1 2 1 ♦  R/U  requests  totaling  1*121*  records  with  3  errors 
AST's  executed:  1*686* 

I  d  3.  e  - 1  o  o  p  i  t  e  r  a  1 1  o  n  s  :  1*670* 


1 0  X  >  E  X I T 


The  command  sequence  in  Example  4-2  does  the  following: 

O  Allocates  drive  MMO:,  mounts  the  magnetic  tape,  and  invokes 
an  installed  version  of  IOX. 

On  RSX11M-PLUS  systems,  you  mount  the  tape  with  the  /FOREIGN 
switch . 

©  Displays  the  initial  defaults. 

©  Selects  pattern  number  12  to  be  written  to  the  tape. 

©  Changes  the  default  BUFFERSIZE  from  1024 ( decimal )  to 
8192 (decimal)  (8K) . 

0  Displays  the  default  density  and  characteristic  word  on  the 
magnetic  tape  mounted  in  drive  MMO:. 

0  Selects  MMO:  for  NFS  testing  with  SELECT,  overriding  the 
defaults  for  RETRIES,  ERRORLIMIT  and  RECORDS,  and  sets  the 
tape  density  at  800 (decimal ) . 

©  Checks  the  parameters  with  PARAMETERLIST  and  DENSITY. 

0  Changes  the  BUFFERSIZE  default. 

0  Changes  the  PATTERN  default. 

<D  Displays  the  device  display  line  for  MMO:. 

0  Shows  the  current  BUFFERSIZE  of  MMO:. 

0  Shows  that  the  number  or  records  to  be  tested  is  20000. 

0  Starts  NFS  testing  with  SELECT  on  MMO:. 

The  remainder  of  Example  4—2  shows  interval  reports ,  error  reports , 
and  accumulated  totals  generated  at  your  terminal  during  this 
exercise.  These  reports  are  discussed  fully  in  Section  4.10.  When 
the  exercise  has  finished,  you  exit  to  the  operating  system  monitor 
unless  you  want  to  do  more  testing . 
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4.8.2  Exercising  with  the  VERIFY  Command 

The  command  sequence  in  Example  4-3  performs  oscillating  seeks  between 
blocks  1  and  1000  to  align  disk  heads.  It  reads  only  4  bytes  per  data 
transfer ,  which  is  the  minimum.  No  error  or  summary  reporting  is 
required.  The  exercise  runs  until  you  abort  it. 

Example  4-3  illustrates  the  following  commands: 

PARAMETERLIST 

Displays  current  default  parameters ;  IOX  buffer  space  statistics/ 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing . 

VERIFY 

Selects  a  mounted  disk  for  an  NFS  exercise  that  reads  buffers  of 
data  without  writing  on  the  disk,  performing  data  comparisons,  or 
destroying  the  contents  of  the  disk. 


RANGE 


Sets  the  minimum  and  maximum  block  numbers  for  NFS  testing  on  the 
specified  disk. 

BUFFERSIZE 

Sets  the  amount  of  data  that  IOX  transfers  for  every  read  or 
write  request  when  testing  NFS  disks,  magnetic  tapes,  and 
cassettes . 

RANDOM 

Directs  IOX  to  select  either  random  or  sequential  blocks  for  disk 
testing. 

INTERLEAVE 

Sets  the  number  of  blocks  to  be  skipped  before  IOX  writes  the 
#next  buffer  of  data  for  disk  testing  (applies  only  to  sequential 
testing  which  you  determine  with  the  RANDOM  command) . 

ERRORLIMIT 

Sets  the  maximum  number  of  errors  that  IOX  tolerates  between 
interval  reports  before  terminating  testing  on  a  device. 

REPORTERRORS 

Enables  or  disables  error  reports . 

SUMMARYTIME 

Determines  how  often  (in  minutes)  IOX  will  output  interval 
reports . 

RUNTIME 

Sets  the  length  of  time  (in  minutes)  that  IOX  exercises  the 
unit(s)  you  have  selected  for  testing. 
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LOGFILE 

Determines  whether  IOX  directs  activity  and  error  reports  to  your 
terminal  or  to  a  log  file. 


START 


Starts  exercising  units  that  you  have  selected  for  testing. 

CTRL/C 

With  CONTROL_C  enabled,  allows  you  to  enter  IOX  commands  while  an 
exercise  is  in  progress. 

ABORT 

Terminates  execution  of  an  I/O  exercise. 


Example  4-3  Exercising  an  NFS  RK07  with  the  VERIFY  Command 


>  ALL  DM0  :  "I 

>  MOD  DM0 :  >  O 

>I0X  J 

IGX>  PAR 

BUFFERSIZE-555  1.024. 
ERRORL.IMIT  5555  10. 
INTERLEAVE-  4. 

PATTERN25  0. 

RECORDS5555  1  024  . 

RUNTIME  5555  5  . 

SUMMARYTIME  5555  1  . 
TEMPORARYFILE  5555  500  . 


COMPAREDATA5555  YES 

CONTROL . C  5555  YFS 

LOGFILE  5555  NO 
LOOPBACK  5555  NO 
RANDOM  5555  YES 
REPORTFRRORS  5555  YFS 
RETRIES  5555  YES 
V0L.UMECHE CK  5555  YFS 
WAIT  5555  YES 
WRITECHECK  5555  NO 


e 


Buffer  space  usaSe-  3290 


924. :  1924. :  1  ♦ 


J 


I0X> VERIFY  D M 0 :  RAN6E=1 $ 1 000  BUF  =  4  R  A  N  R  =  N  INTER  =  999  FRR=50000  0 
I0X>  RFP0RTERR0RS  NO 
I 0X> SUMMARY  0 
I0X> RUNTIME  0 
I0X> LOG  Y 
I0X>  PAR 


D  e  v  ice  Mode  Buffersize  F  i  ]  e  s  i  z  e  /  R  e  c  o  r  ds/RanSie  Para  m  eters 


DM0 :  VFY  4. 

BUFFERSIZE5555  1  024  . 
ERRORL.IMIT  5555  1  0  . 
INTERLEAVE  5555  4  . 
PATTERN  5555  0  . 

RECORDS5555  1  024  . 
RUNTIME  5555  0  . 
SUMMARYTIME  5555  0  . 
TEMPORARYFILE  5555  500. 


1.  -->  1?  000. 

COMPAREDATA 5  YES 
CONTROL.  .C=  YES 
LOGFILE  5555  YES 
LOOPBACK  5555  NO 
RANDOM  5555  YES 
REPORTERRORS  5555  NO 
VOL  U M E CHECK  5555  YES 
WAIT  5555  YES 
WRITECHECK  5555  NO 


RET  I N T 5555 9 9 9  ♦  ERR  =  50000 


Buffer  space  usaSe5555  3290  .  1 1912.  J 1912.  :  1  * 


1 0 X >  ST  1 

I0X>"C  ?  0 

I0X> ABORT  J 
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The  command  sequence  in  Example  4-3  does  the  following: 

Q  Allocates  drive  DMO:,  mounts  the  RK07  for  NFS  testing,  and 
invokes  IOX. 

On  RSX11M-PLUS  systems,  mount  disks  with  the  /FOREIGN 
switch . 

0  Displays  the  initial  default  parameter. 

0  Selects  DMO:  for  read-only  NFS  testing  with  VERIFY, 

overriding  the  following  defaults: 

a.  RANGE  —  blocks  1  through  1000 

b.  BUFFERSIZE  —  minimum,  four  bytes 

c.  RANDOM  block  testing  turned  off  and  INTERLEAVE  set  at 
999  so  that  IOX  tests  only  blocks  1  and  1000 

d.  ERRORLIMIT  set  impossibly  high  (50000.)  so  that  IOX  will 

not  deselect  DMO:  no  matter  how  many  errors  are 

encountered  during  the  exercise 

O  Turns  off  REPORTERRORS  so  that  no  error  reports  are 
generated.  Turns  SUMMARYTIME  off  so  that  no  interval 
reports  will  be  generated.  Sets  RUNTIME  to  zero  so  that  IOX 
runs  the  exercise  until  you  abort  it.  Sets  LOGFILE  YES  to 
direct  all  output  to  the  log  file,  IOX. LOG,  instead  of  to 
the  terminal. 

©  Shows  that  the  RUNTIME,  SUMMARYTIME,  and  LOGFILE  defaults 
have  been  reset  and  that  DMO:  is  being ^ tested  with  VERIFY, 
using  a  buffersize  of  4.,  over  a  range  of  1000.  blocks, 
with  RETRIES  enabled,  INTERLEAVE  set  at  999,  and  ERRORLIMIT 
set  at  50000. 

0  Shows  how  to  start  the  exercise  using  the  START  command  and 
enter  Interactive  Mode  with  CTRL/C  so  you  can  enter  the 
ABORT  command  to  abort  the  exercise. 

Example  4-4  shows  the  contents  of  the  log  file  for  Example  4-3. 


Example  4-4  Log  File  Output  for  Example  4-3 

IOX  —  20-JUL-85  185  24  M2  ********  EXERCISER  STARTED  ******** 


D e v :L c e  M a d e  6 u f  P e r a  i  <■>  F :i.  1  e s :L  z e / R e cot- d s / R a n d e  P a r a m e t e r s 


DMO:  I'FY  4,  1*  ->  1.  f  000* 


RET  INT-999#  ERR*50000* 


B  l)  F  F  E  R  S I Z  E  *  1024  ♦  C  0  M  P  A  R  E  D  A  T  A  *  Y  F  S 


ERRORLIMIT »  .10* 
INTERLEAVE-  4  * 
PATTERN-  0* 
RECORDS-  1024* 
RUNTIME-  0* 


CO NTROl . C  =  YES 

I ...  0  G  F I L  E  -  YES 
LOOPBACK*  NO 
RANDOM-  YES 
REPORTERRORS-  NO 


SUMMARYTIME-  0* 

T E M P 0 R  A R  Y F 1 1 .. E  -  500 


RETRIES*-  YES 
VOLUME CHECK*  YES 
WAIT*  YES 
WRITE CHECK*  NO 


(continued  on  next  page) 


4-17 


THE  I/O  EXERCISER  (IOX) 


Example  4-4  (Cont.)  Log  File  Output  for  Example  4-3 


Buffer  space  usa«f*}=  3290. J 1812. J 1812. J 1 . 


IOX  —  Summary  of  exerciser  activity  at  20-JUL.-85  18!  27528 

TIME  -  -  Run*  3  m  i  n  ♦  Elapsed*  3  m  i  n  ♦  R  e  m  a  i  n  i.  n  *i  *  65533  m  i.  n  * 

DM0*  -  -  3*07  5  ♦  R  /  W  r  e  «  u  e  s  t  s  t  o  t  a  3  in  3  3*075*  h  3  o  c  k  s  w  :i  t  h  n  o  e  r  r  o  r  s 
AST's  executed  t  3*081* 

I  d  J  e '■  1  o o p  i  t e  r a t  :i  onsl  2  *  ? 8 2  ♦ 


A  C  C  U  M  U  I.  A  T  E  D  T  0  T  A  L  S  : 

T  3  M  E  -  -  R  u  n  t  0  ir«  :i.  n  *  F 1  a  p  s  e  d  t  3  mi  n  *  R  e  m  a  i  n  i  n  d  *  65  5  3  3  m  :i.  n  * 

D  M  0  \  A  -  -  3*076*  R  /  W  r  e  ci  u  e  s  t  s  i  o  t  a  3  :i.  ri  d  3*076*  b  3  o  <:•  k  s  w  :i  t  k  ri  o  e  tv  r  a  r  s 
AST's  executed:  3*082* 

1  d  1  e  -  3  o  o  p  i  t  e  r  a  t  :i  o  ri  s  :  2  ?  9  B  2  ♦ 

IOX  —  20- JUI..-85  1.8**  27t  31  ********  EXERCISER  ABORTED  ******** 


The  log  file  output  terminates  when  you  abort  the  Exerciser.  The  log 
file  begins  with  the  time  and  date  that  the  exercise  began  and  the 
current  default  parameters  as  displayed  by  the  PARAMETERLIST  command. 


4.9  IOX  OPERATING  MODES 

IOX  operates  in  three  modes:  Command,  Execution,  and  Interactive. 
This  section  discusses  the  functions  of  these  modes,  how  you  enter  and 
exit  each  mode,  and  what  IOX  commands  are  valid  in  each  mode. 


4.9.1  Command  Mode 

IOX  is  in  Command  Mode  after  you  have  invoked  it  and  have  received  the 
first  IOX  prompt.  (Section  4.2  discusses  IOX  prompts.)  In  Command 
Mode,  no  devices  are  being  exercised,  and  tasks  initiated  by  the 
EXECUTE  command  are  queued  but  not  active  (see  Section  4.12  for  a 
complete  description  of  the  EXECUTE  command.)  You  usually  set 
parameters,  select  devices  for  testing,  and  initiate  tasks  to  be 
executed  in  Command  Mode . 

When  you  press  the  RETURN  key,  you  receive  an  IOX  prompt.  When  you 
press  CTRL/C,  you  exit  to  MCR  for  one  command  line. 


4.9.2  Execution  Mode 

When  you  begin  an  I/O  exercise  by  entering  the  START  command,  IOX 
exits  Command  Mode  and  enters  Execution  Mode.  Once  you  have  entered 
Execution  Mode,  exercises  begin  on  selected  devices,  tasks  initiated 
with  the  EXECUTE  command  begin  executing,  the  IOX  clock  is  turned  on, 
and  activity  and  error  reporting  begin. 

You  set  the  CONTROL_C  parameter  in  Command  Mode  to  allow  or  disallow 
you  to  enter  IOX  commands  while  an  exercise  is  in  progress.  CONTROL_C 
YES  is  the  initial  default  setting. 
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If  you  have  set  CONTROL_C  NO,  then  CTRL/C  in  Execution  Mode  gives 
control  to  MCR  and  you  receive  the  MCR  prompt  (>)  every  time  you  press 
the  RETURN  key  and  "MCR> "  every  time  you  press  CTRL/C  until  the 
exercise  has  terminated.  With  CTRL/C  disabled,  you  cannot  interrupt 
the  exercise,  however,  you  can  terminate  it  with  the  MCR  ABORT 
command . 

If  you  have  set  CONTROL_C  YES,  IOX  does  not  accept  any  input  from  your 
terminal  except  CTRL/C.  If  you  try  to  enter  anything  but  CTRL/C,  you 
receive  an  error  message  for  each  key  you  press: 

IOX  .  Only  "C  Allowed 

When  you  press  CTRL/C,  you  receive  the  IOX  prompt  instead  of  the  MCR 
prompt  and  IOX  exits  Execution  Mode  and  enters  Interactive  Mode. 


4.9.3  Interactive  Mode 

You  have  access  to  Interactive  Mode  only  if  CONTROL_C  is  enabled. 
When  you  press  CTRL/C  in  Execution  Mode,  IOX  exits  Execution  Mode  and 
enters  Interactive  Mode.  In  Interactive  Mode,  the  RETURN  key  and 
CTRL/C  have  the  same  functions  that  they  have  in  Command  Mode. 

In  Interactive  Mode,  the  exercise  and  tasks  initiated  by  the  EXECUTE 
command  are  running.  Activity  reports  and  error  reports  directed  to 
your  terminal  are  suspended  if  you  have  set  LOGFILE=NO.  If  you  have 
set  LOGFILE=YES,  activity  and  error  reports  continue  as  in  Execution 
Mode  . 

All  IOX  commands  except  the  following  are  valid  in  Interactive  Mode: 

BUFFERSIZE 

PATTERN 

RUNTIME 

START 

RESTART 

If  you  enter  these  commands,  IOX  prints  the  error  message: 

1 0  X  -  -  C  o  m  m  a  n  d  v  a  1  i  d  o  n  1  h  i  \ 1  o  a  m  m  a  n  d  m  o  d  e 

You  can  use  the  BUFFERSIZE  command  within  the  SELECT  and  VERIFY 
command  lines  to  override  the  current  defaults  for  the  device  being 
selected,  but  the  BUFFERSIZE  command  cannot  be  used  by  itself  to  reset 
the  default. 

Although  you  cannot  use  the  PATTERN  command  to  choose  a  different 
pattern  to  be  written  to  the  volumes  being  tested,  you  can  use  PATTERN 
with  no  argument  to  display  all  the  patterns. 

The  following  commands  are  valid  only  in  Interactive  Mode: 

ABORT 

PRINTSUMMARY 

PROCEED 

SPY 

Although  you  can  use  PRINTSUMMARY  and  SPY  in  Command  Mode  without 
generating  an  error  message,  these  commands  display  meaningful 
information  only  when  you  use  them  in  Interactive  Mode . 

When  you  use  the  ABORT  command,  IOX  exits  Interactive  Mode  and  enters 
Command  Mode.  The  ABORT  command  with  no  qualifiers  terminates  all 
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exercising  and  all  tasks  initiated  by  the  EXECUTE  command.  This  form 
of  ABORT  is  valid  only  in  Interactive  Mode  because  in  Command  Mode 
there  can  be  no  exercise  or  active  tasks  to  abort. 

The  PROCEED  command  exits  Interactive  Mode  and  enters  Execution  Mode 
unless  no  activity  remains  when  you  issue  PROCEED,  in  which  case  IOX 
aborts  the  exercise. 


4.10  IOX  OUTPUT 

IOX  generates  two  types  of  output :  activity  reports  and  error 
reports.  Activity  reports  summarize  IOX  processing  information,  such 
as  how  long  an  exercise  will  run  and  how  many  ASTs  have  been  executed. 
There  are  two  kinds  of  error  reports:  data  compare  error  reports, 
that  show  where  IOX  finds  errors  on  the  volume  being  tested,  and  I/O 
error  reports,  that  indicate  failed  QIOs  from  a  driver.  You  use  the 
LOGFILE  command  (see  detail  in  Section  4.12)  to  direct  activity  and 
error  reports  to  your  terminal  or  to  a  log  file. 


4.10.1  Activity  Reports 

There  are  thrde  types  of  activity  reports : 

1.  Accumulated  Totals  -  An  activity  report  at  the  end  of  an  IOX 
exercise  that  reports  the  activity  for  the  entire  exercise 

2 .  Interval  Reports  -  An  activity  report  that  summarizes  IOX 
activity  in  the  time  intervals  set  by  the  SUMMARYTIME  command 

3 .  Summary  Reports  -  A  report  of  activity  between  the  last 
Interval  Report  and  the  time  you  enter  the  PRINTSUMMARY 
command  to  request  a  summary  report . 

Section  4.12  discusses  the  SUMMARYTIME  and  PRINTSUMMARY  commands  in 
detail . 


4.10.1.1  The  Format  of  Activity  Reports  -  The  formats  of  activity 
reports  are  indentical  except  for  the  first  line.  Interval  and 
summary  reports  begin  with  the  time  and  date  of  the  report.  For 
example : 


1 0  X  -  --  S  u  m  m  a  r  y  o  f  e  x  e  r  c  :i  s  e  r  a  c  t  i  v  i  t  y  a  t  2  0  -  J  U  L  -  8  5  1 1  ♦  1  6  ♦  2  6 

The  accumulated  totals  report  does  not  give  the  time  or  date  of  the 
report  and  begins : 

A  C  C  IJ  M  IJ  L  ATE  D  T  0  T  A  L  8  t 


4.10.1.2  The  Content  of  Activity  Reports  -  The  content  of  all 
activity  reports  is  identical.  The  following  is  an  interval  report  of 
an  exercise  that  tests  SYO:. 

IOX  Summary  of  exerciser  activity  at  31-DEC-85  11*18*29 
TIME  -  -  R  u  n  ♦  1  m  i  n  ♦  F I  a  p  s  e  d  ♦  2  min*  F<  e  m  a  i  n  i  n  $  X  3  m  a  n  ♦ 

SYOt  --  I? 874*  R/UI  reguests  totaling  If  874*  blocks  with  no  errors 
ASTs  exec  u t  e  d ♦  1 f  8  7  5 ♦ 

Idle  -■  1  o  o  p  i  t  e  r  a  t  i  o  n  s  t  1  f  8  0  3  * 
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The  activity  report  contains  the  following  information: 

•  Timing  information 

-  Time  between  reports  as  set  in  the  SUMMARYTIME  command 

-  Time  that  the  exercise  has  been  in  progress  to  the  nearest 
minute 

-  Time  remaining  to  the  nearest  minute  before  the  exercise 
will  finish 

•  Unit  information  for  each  unit  being  tested 

-  Number  of  I/O  requests  to  the  unit 

-  Number  of  blocks  exercised  for  disks  and  tapes 

-  Number  of  bytes  exercised  for  terminals 

-  Number  of  error  encounters  on  the  unit 

•  Number  of  ASTs  executed 

•  Number  of  iterations  through  the  idle  loop 

You  use  the  following  commands  to  control  the  output  of  activity 
reports : 

LOGFILE 

PRINTSUMMARY 

SPY 

SUMMARYTIME 

Section  4.12  discusses  each  of  these  commands  in  detail. 


4.10.2  Error  Reports 

You  use  the  REPORTERRORS  command  to  enable  or  disable  error  reports . 
Section  4.12  discusses  the  REPORTERRORS  command  in  detail.  There  are 
two  kinds  of  error  reports:  data  compare  error  reports  and  I/O  error 
reports . 


4.10.2.1  Data  Compare  Error  Reports  -  A  data  compare  error  means  that 
the  driver  returned  a  success  I/O  code  to  IOX  but  that  the  data 
written  to  the  volume  and  the  data  read  from  the  volume  did  not  match. 
The  following  is  an  error  report  generated  by  a  data  compare  error: 

IOX  —  DR1 :  data  compare  error  at  block  33,937  (decimal)  102221  (octal) 
Good  Data:  005767  Bad  Data:  155555  ©  Q 

Word  Position:  0  (decimal)  0  (octal)  0 
Buffer  contained  255.  additional  errors  © 

©  Identifies  the  device  on  which  IOX  encountered  an  error.  It 
reports  the  starting  block  (in  both  decimal  and  octal)  in 
which  the  error  was  found . 

0  Shows  the  "good  data"  that  IOX  wrote  to  the  volume  and  the 
"bad  data"  that  IOX  read  from  the  volume.  Only  the  first 
error  encountered  in  the  test  buffer  is  reported. 
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0  Shows  the  position  of  the  first  word  in  the  test  buffer  that 
generated  a  mismatch  during  the  current  operation.  Only  the 
first  error  encountered  in  the  test  buffer  is  reported. 


O  Shows  how  many  other  errors  were  found  in  the  test  buffer. 


4.10.2.2  I/O  Error  Reports  -  There  are  12  I/O  errors.  If  a  QIO 
fails ,  the  driver  returns  an  I/O  failure  code  to  IOX.  IOX  generates  a 
specific  I/O  error  report  as  a  result  of  the  following  I/O  errors: 


I/O  Code 


Description 


Operation  aborted 
Bad  block 
Data  overrun 
Device  not  ready 
End-of-tape  detected 
Fatal  hardware  error 
Device  off-line 
Privilege  violation 
Unrecoverable  error 
Write  check  error 
Write-lock  error 
Unexpected  error 


IE. ABO 
IE.BBE 
IE. DAO 
IE.DNR 
IE. EOT 
IE.FHE 
IE.OFL 
IE.PRI 
IE.VER 
IE.WCK 
IE.WLK 
N/A 


These  error  codes  are  shown  in  the  RSXllM/M-PLUS  I/O  Drivers  Reference 
Manual .  Section  4.13  of  this  chapter  presents  the  format  and  content 
of  the  12  error  messages  that  IOX  generates  because  of  these  error 
codes . 


4.11  THE  TASK-BUILD  FILE 

You  can  change  the  initial  defaults  for  IOX  parameters  as  well  as 
other  defaults  of  the  IOX.TSK  by  editing  the  IOX  task-build  file, 
IOXBLD . BLD . 


On  RSX-11M  systems ,  this  file  is  located  on  your  system  disk  in  UFD 
[1,24]  for  mapped  systems  and  [1,20]  for  unmapped  systems. 

On  RSX-11M-PLUS  systems,  this  file  is  located  on  your  system  disk  in 
UFD  [1,24]. 


4.12  COMMAND  DESCRIPTIONS 

This  section  provides  complete  descriptions  of  the  commands  in  the  IOX 
Command  Language.  Each  command  description  includes  the  following: 

•  Kind  of  command  by  category:  Function,  Display,  Parameter, 

and  Control. 

•  All  command  formats. 

•  Qualifier  descriptions. 

•  Operating  mode  restrictions.  (Where  no  mode  restrictions  are 
placed  on  a  command,  it  is  valid  in  Command  Mode  and 
Interactive  Mode . ) 
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•  Kinds  of  devices  and  testing  to  which  the  command  applies 

•  Initial  defaults,  if  applicable. 

The  commands  are  presented  alphabetically. 


Commands  may  be  issued  in  all  uppercase,  all  lowercase,  or  part  upper 
and  part  lowercase.  You  can  abbreviate  commands  using  any  combination 
of  characters  that  appear  unique  to  the  IOX  Command  Language. 

All  commands  are  represented  by  unabbreviated  uppercase  letters.  All 
lowercase  words  in  the  presentations  of  command  syntax  indicate  that 
you  substitute  alphanumeric  characters  for  the  word. 


All  numerical  qualifiers  are  decimal. 

Brackets  [  ]  indicate  optional  elements  in  the  command  line . 


4-23 


THE  I/O  EXERCISER  (IOX) 


ABORT 


A[BORT]  [/ALL] 

[taskname] 

The  ABORT  command  is  an  IOX  control  command.  You  cannot  use  the  ABORT 

command  to  abort  a  task  that  has  attached  your  terminal,  such  as  PIP. 

There  are  three  forms  of  ABORT: 

ABORT  Terminates  the  execution  of  an  I/O  exercise  and 

tasks  initiated  by  the  EXECUTE  command.  This  form 
of  ABORT  is  valid  only  in  Interactive  Mode 
(testing  in  progress)  because  in  Command  Mode  (no 
testing  in  progress)  there  can  be  no  running 
exercise  or  active  tasks  to  abort. 

ABORT/ALL  In  Interactive  Mode,  this  form  of  ABORT  terminates 

the  execution  of  all  tasks  initiated  by  the 
EXECUTE  command  and  removes  the  tasks  from  the 
list  of  tasks  to  be  executed.  In  Command  Mode, 
this  form  of  ABORT  removes  all  tasks  from  the  list 
of  tasks  to  be  executed. 

ABORT  taskname  In  Interactive  Mode,  this  form  of  ABORT  terminates 

the  execution  of  a  task  initiated  by  the  EXECUTE 
command  and  removes  the  task  from  the  list  of 
tasks  to  be  executed.  In  Command  Mode,  this  form 
of  ABORT  removes  the  task  from  the  list  of  tasks 
to  be  executed. 
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BADBLOCKS 


BA[DBLOCKS]  ddnns  [blocknumbers] 

You  can  use  BADBLOCKS  as  a  device-dependent  parameter  command  or  as  a 
display  command.  Note  that  the  BADBLOCKS  command  applies  only  to  NFS 
disk  testing. 

BADBLOCKS  requires  a  device  specification  "dduu : " .  To  use  the 
BADBLOCKS  command,  the  disk  that  you  specify  must  already  be  selected 
for  NFS  operations . 

BADBLOCKS  as  a  Parameter  Command 

With  the  BADBLOCKS  Parameter  Command,  you  can  omit  the  bad  blocks  on 
your  disk  from  IOX  testing.  BADBLOCKS  does  not  find  bad  blocks  on 
your  disk;  it  allows  you  to  enter  those  blocks  that  the  BAD  utility 
has  reported  to  be  bad  into  an  IOX  bad  blocks  list  for  the  disk.  When 
you  exercise  the  disk  with  SELECT  or  VERIFY,  the  blocks  that  you 
entered  in  the  list  will  not  be  exercised.  IOX  omits  only  those 
blocks  that  you  listed  as  block  numbers  in  the  BADBLOCKS  command  line; 
blocks  marked  as  bad  by  the  BAD  utility  but  not  entered  into  the  bad 
blocks  list  with  the  BADBLOCKS  command  are  treated  as  good  blocks  by 
IOX. 

Once  you  have  made  entries  in  the  bad  blocks  list  for  a  disk,  the 
block  numbers  that  you  entered  remain  on  the  list  until  you  deselect 
the  disk. 

There  are  two  formats  for  entering  bad  blocks  into  the  bad  blocks 
list.  One  format  is  illustrated  in  the  following  two  examples: 

BADBLOCKS  DM1 :  3 

This  command  line  (which  uses  DM1:  as  an  example)  enters  block  3  in 
the  bad  blocks  list  for  DM1:. 

BADBLOCKS  DM1 : '  3,4,5,11,12,13,99, 151 

In  this  second  example,  the  command  line  enters  blocks  3,  4,  5,  11, 

12,  13,  99,  and  151  into  the  bad  blocks  list  for  DM1:. 

The  second  format  has  the  following  form: 

beg :num 

where : 

beg  Beginning  block  number, 
num  Number  of  sequential  blocks. 

For  example : 

BADBLOCKS  DM1:  3:3,10:4,100:50 

This  command  line  enters  blocks  3  through  5,  10  through  13,  and  100 
through  149  into  the  bad  blocks  list  for  DM1:.  You  can  use  this 
format  for  the  length  of  a  single  command  line. 
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BADBLOCKS  (Cont.) 


You  can  use  the  two  formats  together  on  the  same  command  line.  For 
example : 

BADBLOCKS  DM1 :  3:3,10:4,99, 100 : 50 , 151 

This  command  line  enters  blocks  3  through  5,  10  through  13,  99,  100 

through  149,  and  151  into  the  bad  blocks  list  for  DM1:. 

BADBLOCKS  as  a  Display  Command 

BADBLOCKS  with  no  block  numbers  specified  is  a  Display  Command.  For 
example : 

BADBLOCKS  DM1: 

This  command  line  displays  the  bad  blocks  list  for  DM1:.  If  you  type: 

BADBLOCKS  DM1:  3:5,10:4,99,100:50,151 

IOX  would  display: 

000003:005 

000010:004 

000099:051 

000151:001 

IOX  displays  the  bad  blocks  list  using  a  variation  of  the  second 
format.  It  strings  consecutive  blocks  together  even  if  you  did  not 
enter  them  using  the  second  format.  For  example,  in  the  command  line, 
you  entered: 

99,100:50. . . . 

However,  when  IOX  displays  the  bad  blocks  list,  it  does  not  separate 
these  because  blocks  99  and  100  are  consecutive  blocks.  It  does  not 
display  two  lines :  one  for  block  99  and  one  for  blocks  100  through 
149.  Instead,  it  displays  (line  three)  the  bad  blocks  list  in  one 
line  as  if  you  had  entered  51  blocks  (99:51)  beginning  with  block  99 
in  the  bad  blocks  list. 
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BUFFERSIZE 


BU[FFERSIZE]  buffersize 

BUFFERSIZE  is  a  device-dependent  parameter  command.  You  use 
BUFFERSIZE  to  determine  the  amount  of  data  that  IOX  transfers  for 
every  read/write  operation  request  when  exercising  NFS  disks, 
terminals,  magnetic  tapes,  and  cassettes.  IOX  stores  the  specified 
size  in  bytes  and  rounds  this  number  up  to  the  next  4-byte  boundary. 

When  you  use  the  random  data  pattern  (PATTERN  0),  BUFFERSIZE  should 
never  exceed  3400 (decimal)  bytes,  or  IOX  generates  unpredictable  data 
compare  errors . 

Although  read/write  buffers  are  used  for  FILES11  disk  testing  and  for 
NFS  testing  with  DECtapes,  the  buffersize  for  these  devices  is  fixed. 
A  512 (decimal) -byte  buffer  is  used  for  all  FILES11  testing.  A 
1024 (decimal) -byte  buffer  is  used  for  all  DECtape  testing. 

The  BUFFERSIZE  command  is  valid  only  when  used  by  itself  in  Command 
Mode.  In  addition,  it  is  valid  only  if  units  are  not  currently 
selected;  that  is,  you  must  set  your  default  buffer  size  before  you 
select  any  units  for  testing.  However,  you  can  use  the  BUFFERSIZE 
command  in  the  SELECT  and  VERIFY  command  lines  to  override  the  default 
buffer  size  for  the  selected  device  as  long  as  you  set  the  buffer  size 
smaller  than  the  default. 

The  initial  default  is  1024 (decimal )  bytes.  The  default  buffersize 
for  terminals  is  the  size  of  the  typeahead  buffer,  if  typeahead  is 
enabled.  Otherwise,  the  default  is  96 (decimal)  bytes. 
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COMPAREDATA 


COM [ PAREDATA ]  Y[ES]/N[0] 

COMPAREDATA  is  a  device-dependent  parameter  command  for  FILES 11  and 
SELECT  that  applies  to  the  testing  of  devices. 

COMPAREDATA  enables  or  disables  the  checking  of  the  data  pattern. 
COMPAREDATA  YES  enables  data  pattern  checking;  COMPAREDATA  NO  disables 
data  pattern  checking.  When  you  direct  IOX  to  compare  data  patterns, 
it  compares  the  data  that  it  writes  to  the  unit  with  the  data  it  reads 
from  the  unit.  If  the  data  read  does  not  match  the  data  written,  IOX 
prints  a  data  compare  error  report.  Section  4.10.2.1  discusses  data 
compare  error  reports  in  detail. 

You  can  use  COMPAREDATA  within  the  command  lines  of  FILES11  and  SELECT 
to  override  the  current  COMPAREDATA  setting  for  the  device  being 
tested . 


The  initial  default  is  COMPAREDATA  YES. 
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CONFIGURE 


CONF[IGURE]  [dduu s [=type] ]  .... 

CONFIGURE  is  a  general  parameter  command  and  a  display  command.  You 
use  CONFIGURE  as  a  parameter  command  to  add  devices  to  your  test 
configuration  and  as  a  display  command  to  display  the  current 
configuration . 

IOX  configures  by  default  one  of  each  supported  device  type  as  unit 
"0".  Allowable  device  types  are  either  DISK,  TERM,  or  TAPE.  You  can 
add  any  device  to  the  test  configuration  to  which  you  can  assign  a 
logical  device  name  by  using  the  MCR  ASN  command.  When  you  configure 
a  device,  IOX  adds  the  device  to  its  list  of  devices  available  for 
testing  and  creates  an  empty  data  structure  for  the  device. 

If  a  device  is  not  already  included  in  the  test  configuration,  you 
must  configure  it  before  you  can  select  it  for  testing.  IOX  does  not 
unconfigure  devices  at  the  end  of  an  exercise .  Once  you  have  included 
a  device  in  the  test  configuration,  only  RESTART  will  unconfigure  it. 

CONFIGURE  with  no  qualifiers  displays  the  current  test  configuration. 
To  find  out  if  a  device  is  already  configured,  type  the  following: 

I0X> CONFIGURE 

IOX  responds  as  follows: 


Disks : 


DBO  DDO 

DFO 

DKO 

DLO 

DM0 

DPO 

DXO  DYO 

EMO 

SYO 

Tapes : 

CTO  DTO 

MFO 

MMO 

MSO 

MTO 

MUO 

Terminals : 
TTO 


DRO  DSO 


DUO 


To  add  devices  to  the  test  configuration,  type  the  following: 

IQX>  CONFIGURE  RK1  ♦  DPI  5  FUR2  t  .  XX  J  YY  ♦  MM5J  MQ1  ♦  =T APE 

This  command  line  configures  devices  DK1 : ,  DB1 : ,  DB2 : ,  XXO : ,  and  YYO : 
as  disk  units.  It  configures  devices  MM5 :  and  MQ1:  as  tape  units. 

You  must  separate  unit  specifications  with  spaces  or  tabs. 

Use  the  display  form  of  CONFIGURE  to  check  that  these  devices  have 
been  added  to  your  configuration  as  follows: 

IOX>  CONF 

Disks  : 


DBO 

DB1 

DB2 

DDO 

DFO 

DKO 

DKl 

DLO 

DM0 

DRO 

DSO 

DUO 

DXO 

DYO 

EMO 

SYO 

XXO 

YYO 

Tapes 

: 

CTO 

DTO 

MFO 

MMO 

MM  5 

MQ1 

MSO 

MTO 

MUO 

Terminals : 
TTO 
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If  you  do  not  specify  a  device  type  when  you  configure  a  device,  the 
device  type  defaults  are  as  follows: 

1.  If  one  unit  of  a  device  type  has  already  been  configured  as  a 
disk  and  you  add  a  unit  with  the  same  device  specif ication, 

IOX  also  configures  that  unit  as  a  disk.  For  example, 
because  DKO :  and  DBO :  in  the  previous  example  are 

configured  as  disks  in  the  default  configuration,  IOX 
configures  DK1 : ,  DB1 : ,  and  DB2 :  as  disks.  By  the  same 
logic,  IOX  configures  MM5:  as  a  tape  because  MMO:  has  been 
configured  as  a  tape  unit  by  default. 

IOX  maintains  consistency  in  configuring  device  units. 
Therefore,  you  cannot  configure  DK1 : ,  DB1 : ,  or  DB2 :  as 
tapes.  The  same  holds  true  for  MM5 :  —  you  cannot  configure 
it  as  a  disk.  In  both  cases,  IOX  generates  the  following 
error  message: 

IOX  ~~  dduti*  specified  device  type  is  inconsistent 

2.  For  devices  with  mnemonics  that  have  not  been  previously 
configured,  the  default  is  disk.  Hence,  in  the  following 
example,  IOX  configures  both  XX:  and  YY :  as  disks,  and  MQ1 : 
as  a  tape . 

i o x > c o n f  dki:  dpi:  dp 2 :  xx:  yy:  mmti ♦  mqi:*tape 

IOX  responds  by  displaying  the  following  messages: 

IOX  --  XXO:  device  type  not  specified  -  defaulting  to  'DISK' 

I  OX  -  -  Y  Y  0  :  d e  v  :i.  c e  t  y  p  e  n o  t  s p e c  i  f  :i  ed  -  d e  f  a  u  1 1  i  n 3  t  o  'DISK' 
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CTRL/C  is  a  control  command.  In  Command  Mode  and  Interactive  Mode, 
CTRL/C  generates  an  MCR  prompt  "MCR> "  allowing  you  to  enter  one  MCR 
command  line.  The  function  of  CTRL/C  in  Execution  Mode  depends  on 
whether  CONTROL_C  has  been  set  YES  or  NO.  If  you  have  set  CONTROL_C 
NO,  then  CTRL/C  generates  the  MCR  prompt  "MCR>"  as  it  does  in  Command 
and  Interactive  Modes.  If  you  have  set  CONTROL_C  YES,  then  CTRL/C 
exits  IOX  from  Execution  Mode  and  enters  Interactive  Mode. 

CTRL/C  exits  to  MCR  by  default  in  Command  and  Interactive  Modes.  In 
Execution  Mode,  CTRL/C  exits  Execution  Mode  and  enters  Interactive 
Mode  by  default. 

Section  4.9  describes  the  three  IOX  operation  modes  in  detail. 
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CONT[ROL_C]  Y[ES]/N[0] 

CONT ROL_C  is  a  general  parameter  command.  You  use  CONTROL_C  to  enable 
or  disable  the  use  of  CTRL/C  to  interrupt  an  I/O  exercise. 

Command  Mode 

CTRL/C  gives  control  to  MCR  for  one  command  line.  The  CONTROL_C 
parameter  has  no  affect  on  CTRL/C  in  Command  Mode. 

Execution  Mode 

If  you  have  set  CONTROL_C  NO,  then  CTRL/C  gives  control  to  MCR 
and  you  receive  the  MCR  prompt  " >"  every  time  you  press  the 
RETURN  key  and  "MCR> "  every  time  you  press  CTRL/C  until  the 
exercise  has  terminated.  With  CTRL/C  disabled,  you  cannot 
interrupt  the  exercise  to  enter  IOX  commands.  However,  you  can 
terminate  it  with  the  MCR  ABORT  command  and  issue  other  MCR 
commands  while  an  exercise  is  in  progress. 

If  you  have  set  CONTROL_C  YES,  IOX  will  not  accept  any  input  from 
your  terminal  except  CTRL/C.  If  you  try  to  enter  anything  but 
CTRL/C,  you  receive  the  following  error  message  for  each  key  you 
press : 


IOX  --  On l*  nC  allowed 

When  you  press  CTRL/C,  you  receive  the  IOX  prompt  instead  of  the 
MCR  prompt  and  IOX  exits  Execution  Mode  and  enters  Interactive 
Mode  . 

Interactive  Mode 

You  have  access  to  Interactive  Mode  only  if  CONTROL_C  is  enabled. 
In  Interactive  Mode,  you  can  enter  most  IOX  commands.  The  RETURN 
key  and  CTRL/C  have  the  same  functions  in  Interactive  Mode  that 
they  have  in  Command  Mode. 

Section  4.9  describes  the  three  IOX  operation  modes  in  detail. 

The  initial  default  is  CONTROL  C  YES. 
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DEN[SITY]  dduus  [n] 

DENSITY  is  a  device-dependent  parameter  command  and  a  display  command. 
The  DENSITY  command  applies  only  to  magnetic  tape  testing  and  requires 
a  magnetic  tape  device  specification  for  "dduu : " . 

You  use  DENSITY  as  a  device-dependent  parameter  command  with  an 
argument  "n"  to  set  the  density  and  characteristic  word  of  a  magnetic 
tape.  (The  device  characteristic  word  is  defined  in  the  RSX-11M-PLUS 
Guide  to  Writing  an  I/O  Driver.)  You  issue  the  DENSITY  command  before 
you  select  the  tape  for  NFS  testing  with  SELECT.  You  can  also  set  the 
tape  density  for  a  magnetic  tape  unit  by  using  the  DENSITY  command 
within  the  SELECT  command  line. 

You  set  all  tape  densities  in  bits  per  inch  (bpi)  using  decimal  values 
for  "n"  .  The  following  tape  densities  are  legal: 


MF: 

MM: 

MS: 

MT: 

MU: 

1600 

800 

1600 

200 

1600 

6250 

1600 

556 

800 

6250 

You  use  DENSITY  as  a  display  command  without  an  argument  "n"  to 
display  the  current  density  of  the  specified  magnetic  tape  unit.  For 
example : 

IOX > DENSITY  MM: 

Density=  1600  BPI  Character ist ic  Word52  004004  (octal) 

This  command  line  displays  the  current  density  and  characteristic  word 
for  MM0:.  To  change  the  tape  density  to  800,  you  type  the  following: 

IOX > D E N S I T Y  MMt  800 

The  DENSITY  command  is  the  only  way  you  can  find  out  what  the  current 
DENSITY  setting  is  on  a  magnetic  tape  (because  DENSITY  is  not 
displayed  by  the  PARAMETERLIST  command) . 

To  display  the  new  tape  density  and  characteristic  word  for  MM0 : ,  you 
type  the  following: 

I0X> DENSITY  MM: 


Density-  800  B P I  Characteristic  W  o  r  d  =  000000  (octal) 

For  tapes  other  than  MT,  MM,  MS,  MU,  and  MF,  enter  the  density  in 
decimal.  However,  IOX  displays  the  density  in  octal  as  the 
characteristic  word.  For  example: 

IOX > D E N s  mq: 

D  e  n  s i t  y -  ?  ?  ?  ?  BPI  Characteristic  Word-  004004  (octal) 

1 0 X > DENS  MQ:  800 

1 0 X > D E N s  mq: 

Density*  ????  BPI 


Characteristic  Word-  001440  (octal) 


THE  I/O  EXERCISER  (IOX) 


DENSITY  (Cont.) 


This  command  sequence  indicates  the  following: 

•  IOX  does  not  know  the  density  of  the  tape  designated  as  MQ: . 
The  characteristic  word  is  the  default. 

•  When  you  set  the  density  of  MQ:  to  800  bpi  (decimal)  and 

display  the  current  density  and  characteristic  word,  the 
density  appears  in  the  characteristic  word  (octal). 

Except  for  MT:  devices,  the  initial  default  density  for  magnetic  tape 
devices  is  1600  bpi.  The  initial  default  for  MT:  devices  is  800  bpi. 
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DES[ ELECT]  ddnn: 

DESELECT  is  an  IOX  function  command.  You  use  DESELECT  to  "deselect" 
devices  that  you  have  selected  for  testing  with  SELECT,  VERIFY,  or 
FILES11 .  DESELECT  requires  device  (dd)  and  unit  (nn)  specifications. 

If  you  issue  the  DESELECT  command  in  Interactive  Mode  (while  testing 
of  the  specified  device  is  in  progress),  testing  on  the  device 
terminates  and  the  device  is  removed  from  the  list  of  devices  to  be 
tested.  If  you  issue  the  command  in  Command  Mode  (while  no  testing  is 
in  progress),  then  DESELECT  removes  the  device  from  the  list  of 
devices  to  be  tested. 

For  devices  that  you  have  selected  for  NFS  testing,  DESELECT  does  the 
following: 

•  Terminates  I/O  operations  (if  they  are  in  progress) 

•  Deletes  the  badblocks  list  associated  with  the  device  (disks 
only) 

•  Deallocates  all  buffer  space  associated  with  the  device 

•  Detaches  IOX  from  the  device 

For  devices  that  you  have  selected  for  FILES11  testing,  DESELECT  does 
the  following: 

•  Terminates  I/O  operations  (if  they  are  in  progress) 

•  Closes  and  deletes  the  temporary  file 

•  Deallocates  all  buffer  space  associated  with  the  device 

The  DESELECT  command  does  not  remove  a  device  from  the  test 
configuration . 
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©  Selected  devices  and  their  device-dependent  parameters . 
These  parameters  correspond  to  the  default  parameters  unless 
you  have  overridden  the  defaults  in  the  command  line  that 
you  used  to  select  the  devices. 

This  part  of  the  display  has  five  fields  that  are  labeled  by  function. 
They  are  as  follows: 

device 

Device  mnemonic  of  the  selected  device . 


mode 


Testing  mode  selected,  either  VERIFY  ( VFY ) ,  SELECT 
(SEL),  or  FILES11  ( Fll ) . 

buf fersize 

Buffer  size  used  for  reading  data  from  the  device  and 
writing  data  to  the  device.  You  can  alter  the  buffer 
size  for  magnetic  tapes,  NFS  disks,  and  cassettes. 
Files-11  disks  have  a  fixed  buffer  size  of  512(decimal) 
bytes.  DECtapes  have  a  fixed  buffer  size  of 
1024 (decimal)  bytes. 

f ilesize/records/ range 

One  of  the  following: 

•  Temporary  file  size  in  blocks  for  disks  selected 
with  FILES11 

•  Number  of  records  to  test  for  magnetic  tapes  and 
cassettes  selected  with  the  SELECT  command 

•  Range  of  blocks  to  be  tested  on  NFS  disks  that  you 
selected  with  the  SELECT  or  VERIFY  command 

parameter 

Device  dependent  parameters.  These  either  specify  a  value, 
such  as  INT=8.  or  ERR=10.  (INTERLEAVE  8  or  ERRORLIMIT  10), 
or  their  presence  indicates  that  you  have  set  a  YES/NO 
parameter  to  YES.  For  example,  in  (4)  RAN  means  that  you 
set  RANDOM  YES;  and,  in  (6),  the  absence  of  RAN  means  that 
you  set  RANDOM  NO.  See  Section  4.6  for  a  list  of  what 
parameters  apply  to  what  devices  and  modes  of  testing. 

O  This  display  line  corresponds  to  the  command  line  discussed 
next . 

0  This  is  the  command  line  that  you  used  to  select  SY :  for 

FILES11  testing,  overriding  the  TEMPORARYFILE  and  ERRORLIMIT 
defaults.  IOX  tests  SY:  as  a  Files-11  device,  using  the 
following  parameters: 

•  A  512-byte  data  buffer  (fixed) 

•  A  TEMPORARYFILE  size  of  800  blocks 


4-46 


THE  I/O  EXERCISER  (IOX) 


PARAMETERLIST  (Cont.) 

•  COMPAREDATA  enabled  (by  default) 

•  RETRIES  enabled  (by  default) 

•  RANDOM  YES  (by  default) 

•  An  error  limit  of  50  errors 


©  The  display  line  corresponding  to  the  command  line  discussed 
next . 

©  The  command  line  you  used  to  select  DM0:  with  VERIFY.  IOX 
tests  DM0 : ,  using  the  VERIFY  mode  with  the  following 
parameters : 

•  The  default  buffer  size  of  1024 ( decimal )  bytes 

•  The  range  of  blocks  200  through  1000 

•  RETRIES  enabled  (by  default) 

•  RANDOM  disabled 

•  The  INTERLEAVE  factor  set  to  8 

•  The  default  error  limit  of  10 

©  The  list  of  tasks  initiated  by  the  EXECUTE  command 

corresponding  to  the  command  line  discussed  next. 

This  part  of  the  display  has  the  following  fields: 

•  Task  Installed  —  taskname  (...BAD) 

•  Status  Execution  —  status  (QUEUED ,  ACTIVE,  SUCCESS, 

WARNING,  ERROR,  SEVERE  ERROR) 

•  Command  Line  —  line  passed  to  the  task 

©  The  command  line  you  used  to  execute  the  BAD  utility. 

In  Command  Mode,  you  can  use  CTRL/0  to  suppress  the  output  of 
PARAMETERLIST.  In  Interactive  Mode,  CTRL/0  has  no  affect  on  the 
output . 
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PAT [TERN]  [patternnumber] 

PATTERN  is  a  general  parameter  command  as  well  as  a  display  command. 
You  use  PATTERN  as  a  parameter  command  (with  an  argument)  to  set  the 
pattern  that  IOX  writes  and  reads  during  I/O  testing.  The  PATTERN 
display  command  (with  no  argument)  displays  all  13  patterns  and  shows 
the  pattern  that  is  the  current  default  with  an  asterisk  (*). 

The  following  example  illustrates  the  default  pattern  when  you  use 
PATTERN  as  a  display  command: 

IGX>PATTERN 

0  ~  Random  Data  * 

1  -  000000 * 000000 

2  «  177777*177777 

3  =  125252*052525 

4  a  165555*133333 

5  a  1. 6 3126*1. 63126 

6  «  055555*155555 

7  a  022222*122222 

8  «  111111,111111 

9  =  007417*007417 

10  =  021042*021042 

11  a  1.04210*104210 

12  a  052652*052652 

To  change  the  default  pattern  from  random  data  to  "125252,052525", 
which  is  pattern  3,  you  type: 

I QX>P AT TERN  3 

Using  the  display  form  of  PATTERN  now  shows  that  the  asterisk  moved 
from  pattern  0  to  pattern  3  after  you  changed  the  default: 

I 0X>PAT TFRN 

0  a  Rand  o  iti  0  a  t  a 
1  =  000000*000000 

2  a  177777*177777 

3  a  125252*052525  * 

4  a  165555*133333 

5  =  163126*163126 

6  a  055555*155555 

7  =  022272*122222 

8  =  111111*111111 
9  a  007417*007417 

10  a  021042*021042 

11  ~  104210*104210 

12  a  052652*052652 

The  form  of  the  PATTERN  command  that  changes  the  pattern  default  is 
valid  only  in  Command  Mode. 

Pattern  0  is  random  data  from  pure  portions  of  the  I/O  Exerciser 
itself.  When  you  use  the  random  data  pattern,  the  buffer  size  should 
never  exceed  3400 (decimal )  bytes  or  IOX  will  generate  unpredictable 
data  compare  errors . 

The  initial  default  pattern  is  random  data,  pattern  0. 


4-48 


THE  I/O  EXERCISER  (IOX) 


PRINTSUMMARY 


PRICNTSUMMARY] 

PRINTSUMMARY  is  a  display  command  that  is  valid  only  in  Interactive 
Mode . 

IOX  outputs  activity  reports  and  error  reports.  Activity  reports 
summarize  IOX  processing  information,  such  as  how  long  an  exercise 
will  run  and  how  many  ASTs  have  been  executed.  There  are  three  kinds 
of  activity  reports:  accumulated  totals,  interval  reports,  and 
summary  reports.  (For  a  complete  description  of  these  three  kinds  of 
activity  reports,  see  Section  4.10.) 

Summary  reports  and  interval  reports  have  the  same  content  and  format . 
However,  IOX  generates  interval  reports  at  the  time  intervals  that  you 
have  set  with  the  SUMMARYTIME  command.  IOX  generates  summary  reports 
when  you  enter  the  PRINTSUMMARY  command  in  Interactive  Mode.  A 
summary  report  summarizes  IOX  activity  between  the  last  interval 
report  and  the  time  you  enter  the  PRINTSUMMARY  command.  IOX  displays 
summary  reports  at  your  terminal  even  if  LOGFILE  is  enabled. 
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PROCCEED] 

PROCEED  is  a  control  command  that  you  use  only  in  Interactive  Mode. 
(Section  4.9  describes  the  three  IOX  operating  modes  in  detail.)  When 
you  enter  the  PROCEED  command,  IOX  exits  Interactive  Mode,  enters 
Execution  Mode,  and  checks  for  IOX  activity.  If  no  exercises  are  in 
progress  and  no  tasks  initiated  by  IOX  are  executing,  then  IOX 
terminates  the  exercise. 

If  there  is  activity,  IOX  resumes  display  of  activity  and  error 
reports  to  your  terminal  if  you  have  set  LOGFILE  NO.  (With  LOGFILE 
disabled,  IOX  suspends  activity  and  error  reports  to  your  terminal  in 
Interactive  Mode.  With  LOGFILE  enabled,  IOX  continues  recording 
activity  and  error  reports  in  the  log  file.) 

Use  the  PROCEED  command  only  if  you  want  IOX  to  terminate  an  exercise 
as  soon  as  activity  terminates,  or  if  you  want  IOX  to  resume  display 
of  activity  and  error  reports  at  your  terminal  with  LOGFILE  disabled. 
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RAND[OM]  y[es]/n[o] 

RANDOM  is  a  device-dependent  parameter  command  that  applies  to  disk 
testing.  The  RANDOM  command  directs  IOX  to  select  either  random  or 
sequential  blocks  for  disk  testing. 

RANDOM  YES  directs  IOX  to  use  its  random  number  generator  to  choose 
the  blocks  on  the  selected  disk  for  exercising.  RANDOM  NO  directs  IOX 
to  sequentially  test  blocks  on  the  disk. 

If  you  set  RANDOM  NO,  IOX  skips  the  number  of  blocks  specified  with 
the  INTERLEAVE  command  before  testing  the  next  block.  For  example: 

I0X> INTFRIFAVF  8 
I0X>RAN1)0M  NO 

In  this  example,  IOX  tests  every  eighth  block  on  the  disk  (that  is, 
block  0,7,15,.  .  .  .). 

You  can  use  the  RANDOM  command  within  the  FILES11,  SELECT,  and  VERIFY 
command  lines  to  override  the  current  default  parameter,  when 
selecting  blocks  for  testing. 

The  initial  default  is  RANDOM  YES. 
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RANG[E]  dduus  [minimum: maximum] 

RANGE  is  a  device-dependent  parameter  command  and  a  display  command. 
The  RANGE  command  applies  only  to  disks  that  you  have  selected  for  NFS 
testing  with  SELECT  or  VERIFY. 

RANGE ,  as  a  parameter  command,  sets  the  minimum  and  maximum  block 
numbers  for  NFS  testing  on  the  specified  disk  unit.  For  example: 


i  o  >•  >  r  m  r»  f  n  i.  o :  300:50  0 

IOX  tests  blocks  in  the  range  300  through  500  on  DLO.  This  form  of 
the  RANGE  command  can  be  used  in  the  SELECT  or  VERIFY  command  lines  to 
specify  the  range  of  blocks  to  be  tested. 


RANGE,  as  a  display  command,  displays  the  current  range  of  blocks  to 
be  tested  on  the  specified  disk  unit.  The  device  must  have  been 
selected  for  testing. 

For  example : 


IOX > RANGE  DLO? 

0*  ->  20*420* 


This  is  the  default  for  RL02  devices.  After  you  issue  the  RANGE 
command  in  the  previous  example,  you  can  use  the  RANGE  command  to 
display  the  current  range  of  blocks  to  be  tested  as  follows: 


] 0X> RANGE  0L0: 
300 *  ->  500* 


This  form  of  the  RANGE  command  cannot  be  used  within  the  SELECT  or 
VERIFY  command  lines. 

The  default  range  for  all  disks  that  have  been  selected  is  zero  to  the 
maximum  block  number  on  the  disk  minus  sixty  ( 0 :maximum-60 ) . 
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REC[ORDS]  recordcount 

RECORDS  is  a  device-dependent  parameter  command  that  applies  to  the 
testing  of  magnetic  tapes  and  cassettes  with  SELECT.  RECORDS 
specifies  a  record  count,  which  is  the  number  of  records  on  the 
magnetic  tape  or  cassette  to  be  exercised.  For  example: 

I 0X> RECORDS  200 

This  command  line  directs  IOX  to  exercise  200  records  on  all  magnetic 
tapes  and  cassettes.  RECORDS  0  directs  IOX  to  test  the  records  on 
magnetic  tapes  and  cassettes  until  it  detects  the  end  of  the  tape,  at 
which  time  IOX  displays  an  end  of  tape  message  and  deselects  the  tape 
unit . 

You  can  use  RECORDS  in  the  SELECT  command  line  to  override  the  default 
recordcount  for  the  magnetic  tape  or  cassette  being  selected. 

The  initial  default  is  1024 (decimal )  records. 
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REPORTERRORS 


REP[ORTERRORS]  y[es]/n[o] 

REPORTERRORS  is  a  general  parameter  command  that  you  use  to  enable 
(REPORTERRORS  YES)  or  disable  (REPORTERRORS  NO)  IOX  error  reports. 
There  are  two  kinds  of  error  reports :  data  compare  error  reports  and 
I/O  error  reports. 

J 

If  a  success  code  is  returned  from  the  device  driver  (meaning  that  a 
QIO  succeeded) ,  but  the  data  that  IOX  wrote  does  not  match  the  data 
that  IOX  read,  then  a  data  compare  error  has  occurred.  Section 

4.10.2.1  illustrates  and  describes  data  compare  error  reports. 

I/O  error  codes  are  returned  from  the  device  drivers  (meaning  that  a 

QIO  failed).  These  error  codes  generate  one  of  12  error  messages 

discussed  in  Sections  4.10  and  4.13. 

IOX  directs  error  reports  to  your  terminal ,  but  with  the  following 
restrictions  s 

•  Error  reports  never  interrupt  activity  reports . 

•  If  LOGFILE  is  enabled,  IOX  enters  error  reports  in  the  log 
file  instead  of  displaying  them  at  your  terminal. 

•  In  Interactive  Mode,  IOX  suppresses  the  printing  of  error 

reports . 

The  initial  default  is  REPORTERRORS  YES. 
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RESTART 


RES[TART] 

RESTART  is  a  control  command.  The  RESTART  command  is  valid  only  in 
Command  Mode.  When  you  restart  the  I/O  Exerciser,  you  effectively 
reinvoke  IOX  without  exiting  to  the  operating  system  monitor. 

The  RESTART  command  performs  the  following  functions: 

•  Deselects  devices  that  are  selected  for  testing 

•  Resets  all  parameters  to  their  initial  defaults 

•  Removes  all  tasks  queued  for  execution  by  the  EXECUTE  command 
from  the  list  of  tasks  to  be  executed 

•  Unconfigures  all  devices  that  you  added  to  the  default 
configuration 
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RETRIES 


RET[RIES]  Y[ES]/N[0] 

RETRIES  is  a  device-dependent  parameter  command  that  applies  to  the 
testing  of  magnetic  tapes  and  NFS  disks.  RETRIES  YES  directs  a  device 
driver  to  use  its  standard  recovery  techniques  to  attempt  to  recover 
from  an  error.  RETRIES  NO  inhibits  an  I/O  driver  from  using  its 
standard  recovery  techniques  when  it  encounters  an  error. 

You  can  use  the  RETRIES  command  within  the  SELECT  and  VERIFY  command 
lines  to  override  the  current  default  for  the  device  being  selected. 

The  initial  default  is  RETRIES  YES. 
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RUNTIME 


RUN [TIME]  minutes 

RUNTIME  is  a  general  parameter  command .  Note  that  RUNTIME  is  valid 
only  in  Command  Mode,  when  no  exercising  is  in  progress. 

You  use  the  RUNTIME  command  to  specify  how  many  minutes  you  want  IOX 
to  test  the  devices (s)  that  you  have  selected  for  testing.  If  you 
specify  RUNTIME  0,  IOX  continues  testing  the  selected  devices  until 
you  abort  the  exercise  with  either  the  IOX  ABORT  command  or  the  MCR 
ABORT  command . 

The  initial  default  is  5  minutes . 
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SELECT 


SE[LECT]  dduus  [command=qualif ier]  .... 

SELECT  is  a  function  command.  The  SELECT  command  selects  a  device 
with  an  NFS  volume  mounted  for  an  I/O  exercise  that  destroys  the 
contents  and  structure  of  the  volume.  Before  using  SELECT,  you  must 
first  configure  the  device  if  it  is  not  in  the  test  configuration. 

When  you  use  the  SELECT  command  to  select  a  device  to  be  tested  as  an 
NFS  volume,  you  can  override  the  current  default  parameters  by  using 
the  commands  in  Table  4-3  within  the  SELECT  command  line. 


Table  4-3 

Parameter  Commands  by  Device  Type  for  the  SELECT  Command 


NFS  Disks 

Cassettes 

DECtapes 

Magnetic 

Tapes 

Terminals 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

VOLUMECHECK 

WRITECHECK 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

RECORDS 

COMPAREDATA 

ERRORLIMIT 

BUFFERSIZE 

ERRORLIMIT 

DENSITY 

RECORDS 

RETRIES 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

LOOPBACK 

The  following 

command  line 

illustrates 

some  of  these 

commands : 

1 0 X > S F L  DL  OJ  RANG-100M000  RF.T  =  YFS  RAND-NO  INT  =  8  BUF  =  2000 


This  command  line  does  the  following: 


• 

Selects  DLO:  for 

I/O 

exercising 

• 

Tests  only  blocks 

100 

through  4000 

• 

Allows  the  driver 

to 

retry  I/O  operations  if 

it  encounters 

errors 

• 

Accesses  the  blocks  on  the  volume  sequentially 

testing  every 

eighth  block 

• 

Uses  a  data  buffer  of 

2000  bytes  for  data  transfer 

Once  you  have  selected  a  device,  the  default  parameters  become  fixed 
for  that  device.  You  cannot  reset  them  without  first  "deselecting" 
the  device. 

When  you  issue  the  SELECT  command  in  Interactive  Mode  (while  an 
exercise  is  in  progress),  IOX  begins  testing  the  specified  device 
immediately.  When  you  issue  the  SELECT  command  in  Command  Mode  (while 
no  exercise  is  in  progress),  IOX  includes  the  specified  device  in  its 
list  of  devices  to  exercise  but  does  not  begin  the  exercise  until  you 
start  the  exercise  with  the  START  command. 


4-58 


THE  I/O  EXERCISER  (IOX) 


SELECT  (Cont.) 


If  no  further  parameter  commands  are  specified  within  the  SELECT 
command  line,  the  device  is  exercised  with  the  parameters  currently  in 
effect.  Note  that  commands  can  be  separated  only  by  spaces  or  tabs. 

Example  4-2  in  Section  4.8.1  illustrates  and  describes  how  you  test  a 
magnetic  tape  unit  with  the  SELECT  command. 
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SPY 


SP[Y]  [dduus] 

SPY  is  a  display  command.  You  use  the  SPY  command  only  in  Interactive 
Mode  (exercising  in  progress)  to  display  status  information  on 
device (s)  being  tested. 

If  you  do  not  specify  an  argument:  with  SPY,  you  will  receive  a  display 
of  status  information  on  all  devices  being  tested.  When  specified 
with  a  device  and  unit  specification,  SPY  displays  status  information 
only  for  the  specified  device.  For  example: 

>SF‘Y  DBO  ♦ 

IOX  outputs  the  following: 


DBO :  ~~  TYPE -FI  1.  VBN  =  305* 


I/O -AST  Queued 


FUNCTION-WRITE 


This  output  indicates  the  following: 

•  Device  being  exercised  (DBO:) 

•  Type  of  testing  being  performed  on  the  device: 
SELECT  (SEL),  VERIFY  ( VFY ) 


FILES11  ( Fll ) , 


•  Virtual  block  number  being  tested  ( 305 (decimal )  in  this 
example),  or,  for  NFS  volumes,  the  logical  block  number 

•  I/O  request  status:  AST  queued,  in  progress,  or  idle 

•  Type  of  I/O  function  being  performed:  READ  or  WRITE 
SPY  always  outputs  to  your  terminal,  even  if  LOGFILE  is  enabled. 
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START 


ST[ART] 

START  is  a  control  command  and  is  valid  only  in  Command  Mode.  When 
you  use  the  START  command,  IOX  exits  Command  Mode  and  enters  Execution 
Mode.  Section  4.9  discusses  the  three  IOX  operating  modes  in  detail. 

After  you  have  set  your  test  configuration  and  selected  the  devices 
you  want  to  test,  use  the  START  command  to  begin  exercising  the 
selected  units.  START  also  turns  on  the  IOX  clock,  begins  activity 
and  error  reporting  (if  you  enabled  error  reporting  with  REPORTERRORS 
YES),  and  begins  executing  tasks  queued  by  the  EXECUTE  command. 
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SUMMARYTIME 


SUCMHARYTIHE]  minutes 

SUMMARYTIME  is  a  general  parameter  command  that  you 
often  (in  minutes)  IOX  outputs  interval  reports, 
for  a  complete  discussion  of  interval  reports), 
interval  reports  by  setting  SUMMARYTIME  to  0. 

The  initial  default  is  1  minute. 


use  to  specify  how 
(See  Section  4.10 
You  can  suppress 
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TEMPORARYFILE 


TCEMPORARYFILE]  filesize 

TEMPORARYFILE  is  a  device-dependent  parameter  command  that  applies  to 
the  testing  of  Files-11  disks  with  the  FILES11  command.  The  FILES11 
command  protects  the  contents  of  the  disk  by  writing  them  to  a 
temporary  file,  which  IOX  deletes  at  the  end  of  the  exercise.  You 
specify  the  file  size  in  blocks. 

You  can  use  the  TEMPORARYFILE  command  in  the  FILES11  command  line  to 
override  the  current  default  for  the  disk  being  selected. 

The  initial  default  is  500  blocks. 
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VERIFY 


VE[RIFY]  dduu:  [command=qualif ier]  .... 

VERIFY  is  a  function  command  you  use  to  select  a  mounted  NFS  disk  for 
an  exercise.  VERIFY  reads  buffers  of  data  without:  writing  on  the 
disk,  performing  data  comparisons,  or  destroying  the  contents  of  the 
disk. 

VERIFY  accepts  the  following  device-dependent  parameter  commands 
within  its  command  line  to  override  the  default  parameters  for  the 
device  being  tested: 

BUFFERSIZE 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

The  following  example  illustrates  how  you  use  the  ERRORLIMIT  and  RANGE 
commands  within  the  VERIFY  command  line  to  override  the  current 
defaults  for  testing  DMO: 

IOX > U  E  R I F  Y  DMO:  RANGE  1.000:3000  ERROR  LT.  hi  1=1 0 0 0 

This  command  line  selects  DMO:  for  read  only  testing  of  blocks  1000 
through  3000  (inclusive)  with  a  maximum  of  1000  errors  before  IOX 
deselects  the  disk. 

Once  you  have  selected  a  device,  the  default  parameters  for  that 

device  are  fixed.  You  cannot  reset  them  without  first  deselecting  the 
device . 

When  you  use  the  VERIFY  command  in  Interactive  Mode  (while  an  exercise 
is  in  progress),  IOX  begins  testing  the  specified  device  immediately. 
When  you  issue  the  VERIFY  command  in  Command  Mode  (while  no  exercise 
is  in  progress),  IOX  includes  the  specified  device  in  its  list  of 

devices  to  exercise  but  does  not  begin  the  exercise  until  you  start 

the  exercise  with  the  START  command. 

If  no  further  parameter  commands  are  specified  within  the  VERIFY 

command  line,  the  disk  is  exercised  with  the  parameters  currently  in 
effect.  Commands  can  only  be  separated  by  spaces  or  tabs. 

Example  4-3  in  Section  4.8.2  illustrates  and  explains  how  you  test  an 
NFS  disk  with  VERIFY. 
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VOLUMECHECK 


VOCLUMECHECK]  Y[ES]/N[0] 

VOLUMECHECK  is  a  device-dependent  parameter  command  that  applies  to 
NFS  disk  testing  with  SELECT.  VOLUMECHECK  enables  or  disables 
checking  of  disks  mounted  as  NFS  volumes  for  a  home  block  and  a 
Files-11  structure.  If  VOLUMECHECK  is  enabled  (VOLUMECHECK  YES),  IOX 
will  not  allow  you  to  use  the  SELECT  command  to  select  a  volume  with  a 
Files— 11  structure.  With  VOLUMECHECK  disabled  (VOLUMECHECK  NO),  IOX 
will  allow  you  to  use  the  SELECT  command  to  select  the  disk  without 
warning  you  that  the  test  will  destroy  the  contents  of  the  disk.  You 
should  use  VOLUMECHECK  YES  unless  you  are  intentionally  writing  over  a 
Files-11  disk. 

You  can  use  the  VOLUMECHECK  command  within  the  SELECT  command  line  to 
override  the  current  default  values  for  the  disk  being  selected. 

The  initial  default  is  VOLUMECHECK  YES . 
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WAIT 


WA[IT]  Y[ES]/N[0] 

WAIT  is  a  general  parameter  command  you  use  to  determine  whether  or 
not  IOX  waits  for  an  event  flag  while  an  exercise  is  in  progress.  The 
WAIT  command  has  no  effect  on  tasks  initiated  with  the  EXECUTE 
command . 

WAIT  YES  requires  IOX  to  wait  for  an  event  flag  to  signal  that  an  I/O 
operation  has  completed.  During  this  time,  the  Executive  may  be  able 
to  execute  another  task. 

If  you  set  WAIT  NO,  IOX  executes  an  idle  loop  during  I/O  operations. 
Setting  WAIT  NO  can  monopolize  system  resources.  Therefore,  you 
should  not  set  WAIT  NO  unless  you  intentionally  want  to  monopolize 
system  resources. 

The  initial  default  is  WAIT  YES. 
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WRITECHECK 


WR[ITECHECK]  y[es]/n[o] 

WRITECHECK  is  a  device-dependent  parameter  command  that  applies  only 
to  testing  NFS  disks  with  SELECT.  You  use  the  WRITECHECK  command  to 
determine  whether  or  not  I/O  drivers  perform  write  checks  to  NFS 
disks . 

If  WRITECHECK  is  enabled,  IOX  writes  data  to  the  disks  by  issuing  an 
IO.WLC  (write  logical  block  with  check)  to  the  driver  instead  of 

IO.WLB  (write  logical  block).  The  disk  controller  reads, 

word-by-word,  a  copy  of  the  data  from  the  data  buffer,  while 
simultaneously  reading  the  same  data  from  the  disk.  The  disk 
controller  compares  the  two  copies  of  the  data.  If  the  copies  do  not 
match,  and  if  RETRIES  is  enabled,  the  driver  repeats  the  original 
write  operation  and  performs  another  write  check.  This  process 
continues  until  the  WRITECHECK  function  succeeds  or  the  retry  count 
for  the  driver  is  exceeded.  If  RETRIES  is  disabled  or  if  RETRIES  is 
enabled  but  the  retry  count  for  the  driver  is  exceeded,  the  driver 

issues  the  "hard"  error  message,  IE.WCK,  and  IOX  generates  an  error 

message . 

You  can  use  the  WRITECHECK  command  within  the  SELECT  command  line  to 
override  the  current  default  for  the  device  being  selected. 

The  initial  default  is  WRITECHECK  NO. 
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4.13  ERROR  MESSAGES 

IOX  generates  two  types  of  error  messages :  error  messages  with  device 
specifications  and  error  messages  without  device  specifications.  IOX 
displays  device  specifications  as  appropriate. 

The  format  for  an  error  message  with  a  device  specification  is  as 
follows : 

taskname  —  ddnn :  message 
taskname 

Name  of  the  IOX  task  that  is  currently  running.  In  the  error 
messages  that  follow,  taskname  is  always  IOX. 

ddnn 

Device  specification  text  of  the  message, 
message 

Information  specific  to  this  message. 

The  format  for  an  error  message  without  a  device  specification  is  as 
follows : 

taskname — message 

where  taskname  and  message  are  the  same  as  defined  in  the  previous 
format . 

All  error  messages  use  the  letter  "x"  to  indicate  that  IOX  substitutes 
the  appropriate  command,  task  name,  or  value  for  "x"  within  the 
message . 


4.13.1  Error  Messages  with  Device  Specifications 

The  error  messages  are  presented  in  alphabetical  order  by  the  first 
letter  following  the  device  specification. 

IOX  —  dduu :  bad  block,  xxx  (decimal)  xxx  (octal) 

Explanation:  IE.BBE  error  code  returned  to  IOX  (bad  block 

error) . 

User  Action:  Use  the  BADBLOCKS  command  (only  for  NFS  disks)  to 
enter  the  block  number  into  the  bad  blocks  list. 


IOX  —  dduu :  block  number  out  of  range 

Explanation:  You  used  the  BADBLOCKS  command  to  enter  a  block 
number  in  the  bad  blocks  list  that  is  outside  the  range  of  blocks 
that  you  specified  with  the  RANGE  command. 
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IOX  _  TTuu:  buffer  size  being  reduced  to  typeahead  buffer  size 

Explanations  The  buffer  size  specified  or  used  by  default  is 
larger  than  the  size  of  the  typeahead  buffer. 

User  Actions  None.  IOX  will  reduce  the  buffer  size  to  equal  the 
size  of  the  typeahead  buffer. 

IOX  —  dduus  buffer  size  is  greater  than  default 

Explanations  The  buffer  size  that  you  specified  in  the  SELECT  or 
VERIFY  command  line  is  greater  than  the  current  default  set  with 
the  BUFFERSIZE  command  by  itself. 

User  Actions  Either  raise  the  default  buffer  size  (using 
BUFFERSIZE  by  itself)  or  lower  the  buffer  size  override  for  the 
device  (using  BUFFERSIZE  within  the  SELECT  or  VERIFY  command 
line) . 

IOX  —  dduus  data  compare  error  at  block  xxx  (decimal)  xxx  (octal) 

Good  data:  xxxxx  bad  datas  xxxxx 

Word  positions  xxx  (decimal)  xxx  (octal) 

Buffer  contained  xx.  additional  errors 

Explanations  IOX  found  an  error  when  comparing  the  data  read 
with  the  data  written.  This  error  message  shows  the  first  block 
number  in  which  the  error  occurred  during  the  transfer,  the  good 
and  bad  data,  the  word  position  of  the  first  error  found  m  the 
buffer,  and  the  number  of  additional  errors  found  in  the  buffer. 
Section  4.10.2.1  discusses  data  compare  error  reports  in  detail. 

User  Actions  None.  If  the  error  persists,  enter  the  block  in 
the  bad  blocks  list  by  using  the  BADBLOCKS  command  (for  NFS  disks 

only) . 

IOX  —  dduu:  data  overrun  at  block  xxx  (decimal)  xxx  (octal) 

Explanations  IE. DAO  error  code  returned  to  IOX  (data  overrun). 
The  record  size  given  was  greater  than  the  record  size  read. 
This  error  occurs  on  tape  devices  only. 

User  Actions  None. 


IOX  —  dduu:  device  type  not  specified  -  defaulting  to  DISK 

Explanations  This  message  tells  you  that  you  are  adding  a  device 
to  your  test  configuration  with  the  CONFIGURE  command  and  that 
IOX  is  configuring  that  device  as  a  disk  by  default. 

User  Actions  None. 

IOX  —  dduu:  did  not  respond  -  unit  now  deselected 

Explanations  The  unit  did  not  respond  to  the  IOX  command  within 
1  minute.  The  device  may  have  been  accidentally  put  off  line  or 
a  tape  drive  may  have  lost  its  column  vacuum. 

User  Actions  Check  the  device. 
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IOX  —  TTuu :  does  not  support  the  LOOPBACK  command 

Explanations  LOOPBACK  cannot  be  used  with  the  selected  terminal 
line .  This  is  because  of  insufficient  support  in  the  terminal 
driver  (LOOPBACK  is  supported  only  with  the  full-duplex  terminal 
driver)  or  because  typeahead  is  disabled. 

User  Actions  For  full-duplex  terminal  driver  systems,  enable 
typeahead . 


IOX  —  dduu  s  does  not  support  the  x  command 

Explanations  The  x  command  is  incompatible  with  the  device 
specification,  dduu s . 

User  Actions  None. 


IOX  —  dduus  duplicate  block  number 

Explanations  The  block  number  you  entered  with  the  BADBLOCKS 
command  is  already  in  the  bad  blocks  list  for  the  device. 

User  Actions  None. 

IOX  —  dduus  end  of  tape  detected  -  unit  now  deselected 

Explanations  10. EOT  error  code  returned  to  IOX  (end-of-tape 
detected).  IOX  attempted  to  write  a  record  past  the  end-of-tape 
marker. 

User  Actions  This  is  an  informational  message  only. 


IOX  —  dduus  error  threshold  exceeded  -  unit  now  deselected 

Explanations  The  number  of  errors  set  with  the  ERRORLIMIT 
command  has  been  exceeded. 

User  Actions  None. 


IOX  —  dduus  error  while  reading  home  block 

Explanations  When  VOLUMECHECK  is  enabled,  this  message  occurs  if 
IOX  detects  an  error  while  attempting  to  read  the  home  block  of  a 
Files-11  device. 

User  Actions  The  disk  you  selected  may  be  defective.  If  you  are 
testing  a  scratch  disk,  select  the  disk  again  with  VOLUMECHECK 
NO. 


IOX  —  dduus  failed  to  attach 

Explanations  IOX  could  not  attach  the  unit. 

User  Actions  The  device  may  be  mounted  or  attached  by  someone 
else.  Make  sure  you  have  allocated  and  mounted  the  device. 

For  RSX1 1M-PLUS  systems,  mount  devices  with  the  /FOREIGN  switch. 
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IOX  —  dduu :  failed  to  detach 

Explanations  An  error  occurred  while  IOX  was  attempting  to 
detach  a  unit  that  it  had  previously  attached. 

User  Actions  None.  This  is  a  possible  operating  system  problem. 


IOX  —  dduu:  failed  to  open  temporary  file 

Explanations  IOX  could  not  find  enough  free  blocks  on  the  disk 
to  open  a  temporary  file  as  large  as  the  one  you  specified  with 
the  TEMPORARYFILE  command. 

User  Actions  Specify  a  smaller  temporary  file  size  either  by 
resetting  the  default  with  the  TEMPORARYFILE  command  or  by  using 
TEMPORARYFILE  within  the  FILES 11  command  line  to  override  the 
default  TEMPORARYFILE  size  for  each  device. 

If  you  are  using  the  default  (500  blocks)  when  IOX  generates  this 
message,  you  need  to  make  room  on  the  disk. 


IOX  —  dduu  s  fatal  hardware  error  -  unit  now  deselected 

Explanations  IE.FHE  error  code  returned  to  IOX  (fatal  hardware 
error) . 

User  Actions  Check  the  hardware. 


IOX  —  dduu:  illegal  density 

Explanation:  The  density  that  you  specified  with  the  DENSITY 
command,  for  the  magnetic  tape  is  illegal. 

User  Actions  Reenter  the  command,  using  a  legal  density.  See 
Section  4.12. 

IOX  —  dduu:  illegal  range 

Explanations  The  range  of  blocks  which  you  specified  on  the 
device  to  be  tested  with  the  RANGE  command  is  out  of  bounds. 

User  Actions  Use  RANGE  with  no  qualifier  to  check  the  default 
range  on  the  device;  then  specify  a  range  within  bounds. 


IOX  —  dduu  s  invalid  block  number 

Explanations  The  block  number  that  you  entered  with  the 
BADBLOCKS  command  was  not  a  valid  block  number  for  the  device. 

User  Actions  None. 


IOX  —  dduu:  I/O  is  unsatisfied  at  timeout  -  function:  xxxx 

Explanations  When  IOX  finishes  processing,  it  waits  5  seconds 
for  I/O  to  stop.  If  a  long  tape  has  not  finished  rewinding,  this 
message  may  occur.  The  function  that  timed  out  is  xxxx. 

User  Actions  None. 
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IOX  —  dduu:  I/O  request  aborted  -  unit  now  deselected 

Explanations  IE. ABO  error  code  returned  to  IOX  (operation 
aborted) . 

User  Actions  None. 

IOX  —  dduus  is  already  configured 

Explanations  You  tried  to  configure  with  the  CONFIGURE  command  a 
unit  that  is  already  in  the  test  configuration. 

User  Actions  Use  the  CONFIGURE  command  as  a  display  command  to 
check  which  devices  are  configured. 

IOX  —  dduus  is  already  selected 

Explanations  You  tried  to  select  a  unit  that  has  already  been 
selected . 

User  Actions  Use  the  PARAMETERLIST  command  to  display 
information  on  all  units  that  are  selected. 

IOX  —  TTuu s  is  logged  in 

Explanations  A  user  is  logged  in  on  the  terminal  selected. 

User  Actions  Select  a  terminal  line  that  is  not  in  use. 

IOX  —  dduu:  is  not  configured 

Explanations  You  issued  a  command  that  is  valid  only  for 
configured  devices. 

User  Actions  Use  the  CONFIGURE  command  to  configure  the  device. 

IOX  —  dduus  is  not  mounted  or  allocated  for  NFS  operations 

Explanations  You  have  selected  a  device  for  testing  with  SELECT 
or  VERIFY  that  is  not  properly  allocated  and  mounted  for  NFS 
testing . 

User  Actions  Allocate  and  mount  the  device. 

For  RSX11M-PLUS  systems,  mount  NFS  devices  with  the  /FOREIGN 
switch . 

IOX  —  dduus  is  not  ready  -  unit  now  deselected 

Explanations  IE.DNR  error  code  returned  to  IOX  (device  not 
ready) . 

User  Actions  Select  the  device  again. 
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IOX  —  dduu:  is  not  selected 

Explanation:  You  issued  a  device-dependent  parameter  command 

(BADBLOCKS  or  RANGE)  that  is  valid  only  after  you  have  selected 
the  device . 

User  Action:  Select  the  device;  then  reenter  the  command. 


IOX  —  dduu:  is  offline 

Explanation:  IE.OFL  error  code  returned  to  IOX  (device  off 

line) .  The  device  was  taken  off  line  while  testing  was  in 
progress ,  or  you  tried  to  select  a  device  that  was  off  line.  If 
testing  was  in  progress  on  the  device  when  it  was  taken  off  line, 
IOX  appends  "  -  unit  now  deselected"  to  the  error  message. 

User  Action:  Ensure  that  the  device  is  on  line. 


IOX  —  dduu:  is  write  locked  -  unit  now  deselected 

Explanation:  IE.WLK  error  code  returned  to  IOX  (write-lock 

error).  The  device  is  write-locked. 

User  Action:  Check  the  device  write-lock/write-enable  switch  and 
the  MCR  write- lock  status. 


IOX  —  dduu:  LUN  assignment  failure 

Explanation:  This  probably  means  that  the  device,  ddnn : ,  is  not 
physically  present  in  your  system.  It  may  also  mean  that  you 
have  exceeded  the  number  of  devices  that  IOX  can  support.  The 
default  is  28  devices;  the  maximum  number  of  devices  is  246. 

User  Action:  If  the  device  is  not  physically  present  in  your 
system  then  take  no  action.  If  you  have  exceeded  the  number  of 
devices  that  IOX  can  support,  then  edit  the  Task  Builder  command 
file,  IOXBLD.CMD  (see  Section  4.11),  to  allow  IOX  to  support  more 
devices . 


IOX  —  dduu:  privilege  violation  -  unit  now  deselected 

Explanation:  IE.PRI  error  code  returned  to  IOX  (privilege 
violation).  The  device  was  not  allocated  or  it  was  mounted  by 
someone  else. 

User  Action:  Check  the  ownership  of  the  device. 


IOX  —  dduu:  specified  device  type  is  inconsistent 

Explanation:  You  tried  to  configure  device  "dduu"  as  a  tape  when 
a  "dd"  device  had  already  been  configured  as  a  disk.  The  same 
holds  true  if  "dd"  had  already  been  configured  as  a  tape  and  you 
tried  to  configure  another  "dd"  device  as  a  disk. 

User  Action:  Use  the  CONFIGURE  command  as  a  display  command  to 
check  on  the  devices  in  your  test  configuration.  Configure  the 
unit  using  a  different  device  mnemonic. 
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IOX  —  dduu:  unexpected  error  #xx 

Explanation:  IOX  received  an  I/O  error  code  that  it  could  not 
process.  The  error  code  is  xx  (octal). 

User  Action:  None. 

IOX  —  dduu:  unexpected  request  to  queue  I/O  -  request  aborted 

Explanation:  IOX  received  an  AST  from  a  device  after  it  had 
deselected  the  device. 

User  Action:  Check  the  device. 


IOX  —  dduu:  unrecoverable  error  at  block  xxx  (decimal)  xxx  (octal) 

Explanation:  IE.VER  error  code  returned  to  IOX  (unrecoverable 

error).  This  code  indicates  an  unrecoverable  error. 

User  Action:  Check  the  device  and  media. 


IOX  —  dduu:  VOLUMECHECK  failure.  Unit  contains  a  home  block 

Explanation:  The  unit  is  file-structured  because  the  device 
contains  a  home  block.  This  error  message  is  generated  by  select 
if  you  try  to  select  a  Files-11  volume  while  VOLUMECHECK  is 
enabled . 

User  Action:  IOX  destroys  information  on  devices  that  you  select 
for  exercising  with  the  SELECT  command.  If  you  want  to  destroy 
the  contents  of  the  disk,  disable  VOLUMECHECK  (VOLUMECHECK  NO) 
and  select  the  device  again. 


IOX  —  dduu:  write  check  error  at  block  xxx  (decimal)  xxx  (octal) 

Explanation:  IE.WCK  error  code  returned  to  IOX  (write  check 

error).  The  write  check  operation  failed  at  block  xxx. 

User  Action:  None. 


4.13.2  Error  Messages  Without  Device  Specifications 

These  error  messages  are  presented  in  alphabetical  order  by  the  first 
letter  following  the  IOX  task  name. 


IOX  —  Indirect  command  file  syntax  error 

Explanation:  There  is  an  error  in  the  indirect  command  file. 

User  Action:  Check  the  indirect  command  file. 


IOX  —  Indirect  command  file  nesting  level  exceeded 

Explanation:  IOX  accepts  indirect  command  files  with  only  one 

level  of  nesting. 

User  Action:  Rewrite  the  indirect  command  file  so  that  it  does 
not  have  more  than  one  level  of  nesting. 
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IOX  —  Aborting  due  to  user  command 

Explanation:  You  aborted  IOX  by  using  the  MCR  ABORT  command. 

User  Action:  Reinvoke  IOX  if  you  want  to  continue  testing. 

IOX  —  EXECUTE  command  is  not  supported 

Explanation:  You  attempted  to  use  the  EXECUTE  command  in  a 

system  that  does  not  support  task  spawning . 

User  Action:  Do  another  SYSGEN  if  you  require  the  EXECUTE 
command  to  properly  test  your  I/O  devices. 


IOX  --  Command  input  I/O  error 

Explanation:  IOX  detected  an  error  when  it  tried  to  read  the 

command  that  you  typed  at  the  terminal. 

User  Action:  Reenter  the  command. 


IOX  -  Command  valid  only  in  Command  Mode 

Explanation:  You  tried  to  enter  a  command  that  cannot  be  entered 

while  an  I/O  exercise  is  in  progress. 

User  Action:  Either  abort  the  exercise  and  enter  the  command  or 
wait  until  the  exercise  has  finished  to  enter  the  command. 


IOX  —  Command  valid  only  in  Interactive  Mode 

Explanation:  You  tried  to  enter  a  command  that  cannot  be  entered 

unless  IOX  is  running. 

User  Action:  Type  START?  then  reenter  the  command. 


IOX  —  Command  not  unique 

Explanation:  The  command  abbreviation  that  you  entered  did  not 

distinguish  it  from  another  command. 

User  Action:  Reenter  the  command  by  using  a  longer  abbreviation. 


IOX  —  Failed  to  close  log  file.  F . ERR=  -x 

Explanation:  IOX  could  not  close  the  log  file  in  your  directory. 

The  FCS  error  returned  was  "-x" . 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
in  the  RSX-11M/M-PLUS  and  Micro/ RSX  I/O  Operations  Reference 
Manual  and  take  the  appropriate  action. 


IOX  --  Failed  to  open  indirect  command  file 

Explanation:  The  FCS  GCML  routine  failed  to  open  the  indirect 

command  file. 

User  Action:  Check  to  see  that  the  file  exists  and  that  you 
specified  the  file  correctly?  then  resubmit  the  file  to  IOX. 
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IOX  —  Failed  to  open  log  file.  F . ERR=  -x 

Explanations  IOX  could  not  open  the  log  file.  The  FCS  error 
returned  was  "-x" . 

User  Action:  The  disk  may  be  write  protected  or  may  not  have 
enough  blocks. 


IOX  —  Failed  to  open  existing  log  file.  F.ERR=  -x 

Explanation:  IOX  could  not  open  a  log  file  that  already  exists 

in  your  directory.  The  FCS  error  returned  was  n-x" . 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
in  the  RSX-1 1M/M-PLUS  and  Micro/RSX  I/O  Operations  Reference 
Manual  and  take  the  appropriate  action. 


IOX  —  Failed  to  truncate/close  log  file.  F.ERR=  -x 

Explanation:  IOX  could  not  truncate  or  close  the  log  file.  The 

FCS  error  returned  was  "-x" . 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
in  the  RSX-1 1M/M-PLUS  and  Micro/RSX  I/O  Operations  Reference 
Manual  and  take  the  appropriate  action. 


IOX  —  Fatal  file  system  error.  F . ERR=  xxx  PC+2=  xxx 

Explanation:  IOX  exited  because  an  error  occurred  while  IOX  was 
trying  to  issue  a  read  or  write.  F.ERR  is  the  octal  error  code 
in  the  File  Descriptor  Block  indicating  the  kind  of  file  error. 
PC+2  is  the  octal  location  of  the  failure  in  the  IOX  code. 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
in  the  RSX-1 1M/M-PLUS  and  Micro/ RSX  I/O  Operations  Reference 
Manual  and  take  the  appropriate  action . 


IOX  —  Fatal  system  error.  DSW=  xxx  PC+2=  xxx 

Explanation:  IOX  immediately  exits  because  a  directive  that  IOX 
issued  failed.  DSW  is  the  Directive  Status  word  in  octal.  PC+2 
is  the  octal  location  of  the  failure  in  the  IOX  code. 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
in  the  RSX-1 1M/M-PLUS  and  Micro/RSX  Executive  Reference  Manual 
and  take  the  appropriate  action. 


IOX  —  Invalid  pattern  number 

Explanation:  You  tried  to  set  a  data  pattern  using  a  pattern 

number  greater  than  12.  The  valid  arguments  for  PATTERN  are  0 
through  12. 

User  Action:  Enter  a  valid  pattern  number. 
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I OX  —  Invalid  task  name 

Explanation:  The  task  name  that  you  specified  with  the  EXECUTE 

command  is  invalid.  The  task  name  is  either  incorrect  or  the 
task  does  not  exist. 

User  Action:  Reenter  the  task  name  correctly  or  determine  if  the 
task  exists. 

IOX  —  No  activity  remains  -  aborting 

Explanation:  In  Execution  Mode,  IOX  determines  whether  or  not 

any  exercises  are  in  progress  or  any  tasks  are  executing  at  one 
minute  intervals.  If  IOX  finds  no  activity,  it  aborts  the 
exercise  and  generates  this  informational  message. 

In  Interactive  Mode,  IOX  determines  whether  or  not  any  exercises 
are  in  progress  or  any  tasks  are  executing  only  when  you  enter 
the  PROCEED  command.  If  there  is  no  activity  when  you  enter 
PROCEED,  IOX  aborts  the  exercise  and  issues  this  informational 
message . 

User  Action:  None. 


IOX  —  No  activity  to  start 

Explanation:  When  you  issued  the  START  command,  no  devices  were 

selected  for  testing  and  no  tasks  were  initiated  for  execution. 

User  Action:  Select  devices  that  you  want  to  test,  and  use  the 
EXECUTE  command  to  initiate  tasks  that  you  want  to  execute. 


IOX  —  No  buffer  space  available 

Explanation:  IOX  does  not  have  adequate  buffer  space  to 

accommodate  all  the  devices  you  selected. 

User  Action:  Either  deselect  some  devices  from  testing  or 

reinstall  or  reinvoke  IOX  with  a  greater  increment. 


IOX  —  No  such  command  -  type  H  for  help 

Explanation:  You  entered  a  command  that  IOX  did  not  recognize. 

User  Action:  Type  H  (abbreviation  for  the  HELP  command),  which 
displays  a  summary  all  IOX  commands. 


IOX  —  No  tasks  to  abort 

Explanation:  You  tried  to  abort  tasks  using  the  ABORT  command 

when  no  tasks  had  been  initiated  by  the  EXECUTE  command. 

User  Action:  None. 
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IOX  —  Only  CTRL/C  allowed 

Explanations  You  set  CONTROL_C  YES  to  enable  you  to  enter  IOX 
commands  while  exercises  are  in  progress.  Therefore,  IOX  only 
accepts  CTRL/C  in  Execution  Mode. 

User  Actions  Enter  CTRL/C  to  exit  Execution  Mode,  then  IOX  is  in 
Interactive  Mode  and  you  can  enter  commands . 


IOX  —  Syntax  error 

Explanations  The  command  line  that  you  entered  contained  a 
syntax  error. 

User  Actions  If  necessary,  check  the  syntax  of  the  command  line 
that  you  entered.  See  Section  4.12  or  type  H  (for  HELP). 


IOX  —  Task  never  executed 

Explanations  The  task  that  you  tried  to  abort  is  not  on  the  list 
of  tasks  initiated  by  the  EXECUTE  command. 

User  Actions  Use  the  PARAMETERLIST  command  to  check  the  list  of 
tasks  to  be  executed. 


IOX  —  Task  "xxxxxx"  is  currently  active 

Explanations  You  tried  to  execute  a  task  that  was  already 
active.  The  name  of  the  task  is  "xxxxxx". 

User  Actions  None. 


IOX  —  Task  "xxxxxx"  is  completed.  Status=  nnnnnnn 

Explanations  The  task  has  completed  execution.  The  name  of  the 
task  is  "xxxxxx".  There  are  four  task  statuses  represented  by 
"nnnnnnn":  SUCCESS,  WARNING,  ERROR,  and  SEVERE  ERROR. 

User  Actions  None. 


IOX  --  Task  "xxxxxx"  is  not  installed 

Explanations  Task  "xxxxxx"  is  not  installed  and  cannot  be 
initiated  using  the  EXECUTE  command. 

User  Actions  Install  the  task  from  a  privileged  terminal. 


IOX  —  Task  "xxxxxx"  is  unable  to  execute 

Explanations  Task  "xxxxxx"  could  not  execute. 
User  Actions  Try  to  execute  the  task  again. 
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IOX  —  Units  are  selected  -  command  ignored 


Explanation:  The  BUFFERSIZE  command  is  valid  only 

are  selected  for  testing. 


if  no  units 


User  Action:  You  can  use  the  BUFFERSIZE  command  within  the 
SELECT  and  VERIFY  command  lines  to  override  the  default  for  each 
device.  However,  if  you  require  a  larger  buffer  size  for  all 
devices,  use  the  DESELECT  command  to  deselect  all  units;  then 
reissue  the  BUFFERSIZE  command. 
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THE  BAD  BLOCK  REPLACEMENT  CONTROL  TASK  (RCT) 


The  Bad  Block  Replacement  Control  Task  (RCT)  handles  bad  block 
replacement  and  recovery  on  Mass  Storage  Control  Protocol  (MSCP)  disks 
such  as  the  RA80.  Bad  block  handling  on  MSCP  disks  consists  of  four 
stages : 

1 .  Detecting 

2 .  Notifying 

3 .  Replacing 

4.  Revectoring 

The  disk  controller  (UDA50)  handles  the  detection  of  bad  blocks  and 
notification  of  the  driver  (DUDRV ) .  The  driver  activates  RCT.  RCT 
performs  all  the  bad  block  replacement  functions  that  enable  the 
controller  to  revector  (redirect)  I/O  from  the  bad  block  to  the 
replacement  block. 

RCT  also  performs  replacement  and  recovery  on  MSCP  disks  that  went  off 
line  during  bad  block  replacement  or  before  the  contents  of  a 
write-back  cache  were  copied  to  the  disk. 


5.1  BAD  BLOCK  REPLACEMENT  FUNCTIONS 

RCT  performs  the  following  bad  block  replacement  functions: 

•  Stores  data  from  the  bad  block 

•  Allocates  a  replacement  block 

•  Updates  data  structures  on  the  disk 

•  Initializes  the  replacement  block 


5 . 2  RECOVERY  TECHNIQUES 

RCT  checks  MSCP  disks  that  have  just  come  on  line  for  two  conditions: 
incomplete  bad  block  replacement,  and  write— back  cache  corruption.  If 
RCT  determines  that  bad  block  replacement  was  partially  completed  when 
the  disk  went  off  line,  RCT  completes  the  bad  block  replacement 
process.  If  RCT  determines  that  the  write-back  cache  was  not  copied 
to  the  disk  before  the  disk  went  off  line,  RCT  software  write-locks 
the  disk  so  that  the  contents  of  the  write-back  cache  are  preserved. 
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5 . 3  INSTALLING  RCT 

If  you  select  a  DU:  device  in  SYS GEN,  RCT...  and  DU DRV  are  both 
built.  RCT...  is  installed  and  DU DRV  is  loaded  in  SYSVMR.CMD.  You 
load  or  install  and  load  RCT...  and  DUDRV  only  if: 

•  You  have  removed  RCT...  and/or  unloaded  DUDRV. 

•  You  have  edited  SYSVMR.CMD  to  exclude  one  or  both. 

If  you  manually  install  RCT...  and  load  DUDRV,  you  must  first  install 
RCT....  Otherwise,  you  receive  a  message  at  the  console  terminal, 
indicating  that  the  Replacement  Control  Task  is  not  installed. 

To  install  RCT,  use  the  following  command  line: 

>  INS  fcRCT/TASK-RCT  ♦  »  ♦ 


5.4  DISK  CONFIGURATION  OF  MSCP  DISKS 

Three  address  spaces  on  MSCP  disks  are  relevant  to  RCT: 

•  Logical  blocks  (LBNs) 

•  Replacement  blocks  ( RBNs ) 

•  Revector  control  tables 


5.4.1  Logical  Blocks  (LBNs) 

Logical  blocks  (LBNs)  are  accessible  to  user  tasks  for  transferring 
data  between  the  disk  and  the  operating  system.  When  the  controller 
encounters  a  bad  LBN  and  notifies  DUDRV,  DUDRV  activates  RCT  to 
replace  the  LBN. 


5.4.2  Replacement  Blocks  ( RBNs ) 

Replacement  blocks  (RBNs)  are  blocks  reserved  throughout  the  disk  that 
RCT  allocates  as  substitutes  for  bad  LBNs.  RBNs  cannot  be  directly 
accessed  by  user  tasks  during  normal  data  transfers. 


5.4.3  Revector  Control  Tables 

The  revector  control  tables  are  accessible  only  by  RCT  (by  way  of 
DUDRV)  and  the  device  controller.  Each  table  entry  corresponds  to  an 
RBN  according  to  its  location  in  the  table .  An  entry  contains  the  LBN 
being  replaced  and  a  code  describing  the  status  of  the  RBN.  There  are 
five  status  codes : 

•  ALLOCATED  -  The  RBN  is  currently  being  used. 

•  UNALLOCATED  -  The  RBN  is  not  being  used. 

•  UNUSABLE  -  The  RBN  cannot  be  used. 
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•  PRIMARY  -  The  first  RBN  read  when  a  bad  block  is  replaced. 

•  SECONDARY  -  The  RBN  read  after  the  primary  blocks  are  read. 

For  a  given  LBN,  a  primary  RBN  is  in  a  predetermined  location,  such  as 
the  last  sector  of  the  same  track  as  the  LBN.  For  that  LBN,  all  other 
RBNs  are  secondary. 

Sector  0  of  the  revector  control  tables  stores  information  in  a  flag 
word  that  enables  RCT  to  determine  if  recovery  techniques  are  required 
when  a  disk  is  brought  on  line . 


5.5  BAD  BLOCK  HANDLING  ON  MSCP  DISKS 

Bad  block  handling  on  MSCP  disks  consists  of  four  stages: 

•  Detection  performed  by  the  device  controller,  UDA50 

•  Notification  performed  by  the  controller  that  notifies  the 
driver,  DU DRV 

•  Replacement  performed  by  RCT 

•  Revectoring  performed  dynamically  by  the  device  controller 


5.5.1  Bad  Block  Detection 

The  UDA50  controller  may  detect  a  bad  LBN  while  processing  an  I/O 
request  from  the  driver. 


5.5.2  Bad  Block  Notification 

When  the  UDA50  controller  detects  a  bad  LBN,  it  notifies  DUDRV  by 
listing  the  bad  LBN  in  an  end  packet.  DUDRV  stores  this  information 
in  pool  and  activates  RCT. 

DUDRV  provides  RCT  with  the  information  necessary  to  perform  bad  block 
replacement : 

•  LBN 

•  I/O  packet  address 

•  Unit  Control  Block  (UCB)  address 


5.5.3  Bad  Block  Replacement 

RCT  performs  the  following  steps  in  bad  block  replacement: 


1. 

Emulates  an  ATTACH  to 
I/O  necessary  for  bad 

the  disk,  inhibiting  all 
block  replacement . 

I/O 

other 

than 

2. 

Reads  the  data  from  the  bad  LBN  into  a  buffer 
space . 

in 

its 

data 
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3.  Determines  which  RBN  on  the  disk  to  use  by  applying  a 
predetermined  algorithm. 

4.  Issues  QIOs  to  DUDRV  that  update  the  revector  control  tables 
(discussed  in  Section  5.4.3). 

5.  Updates  the  header  and  data  of  the  bad  LBN  by  issuing  an 
IO.RPL  to  DUDRV.  This  I/O  function  code  directs  the 
controller  to  indicate  in  the  header  of  the  LBN  that  the  LBN 
has  been  replaced  either  by  a  primary  or  secondary  RBN  and 
writes  128  copies  of  the  address  of  the  RBN  in  the  data  field 
of  the  LBN. 

6.  Initializes  the  RBN  by  writing  the  data  read  from  the  LBN 
back  to  the  bad  LBN.  Because  the  bad  LBN  has  been  replaced 
by  the  RBN,  the  data  is  written  transparently  to  the  RBN  by 
the  controller. 

If  an  RBN  is  bad,  RCT  treats  it  as  a  bad  LBN.  RCT  finds 
another  RBN,  updates  the  revector  control  tables,  marks  the 
old  RBN  as  unusable,  and  initializes  the  new  RBN  by  writing 
the  stored  data  back  to  the  bad  LBN. 

7.  RCT  detaches  the  unit,  and  normal  I/O  to  the  disk  resumes. 


5.5.4  Bad  Block  Revectoring 

Revectoring  is  performed  dynamically  by  the  device  controller.  When 
the  controller  first  accesses  an  LBN  that  has  been  replaced  by  RCT, 
the  controller  revectors  (redirects)  the  I/O  to  the  RBN  that  RCT 
designated  as  the  replacement  for  the  LBN.  Thereafter,  I/O  to  the  bad 
LBN  is  revectored  transparently  to  the  RBN  without  DUDRV  activating 
RCT. 


5. 5. 4.1  Primary  RBNs  -  When  the  controller  detects  a  bad  LBN  whose 
header  indicates  that  it  has  been  replaced  by  a  primary  RBN,  the 
controller  directly  accesses  the  RBN. 


5. 5. 4. 2  Secondary  RBNs  -  When  the  controller  detects  a  bad  LBN  whose 
header  indicates  that  it  has  been  replaced  by  a  secondary  RBN,  the 
controller  must  look  up  the  address  of  the  RBN  before  it  can  access 
the  RBN.  The  controller  finds  the  address  of  the  secondary  RBN  in  one 
of  two  ways: 

1.  Checking  the  data  field  of  the  bad  LBN,  which  contains  the 
128  copies  of  the  RBN 

2.  Checking  the  revector  control  tables  for  the  entry  containing 
the  bad  LBN 


5.6  COMPLETING  PARTIAL  BAD  BLOCK  REPLACEMENTS 

When  a  disk  unit  is  brought  on  line,  RCT  checks  that  no  bad  block 
replacement  was  in  progress  when  the  disk  went  off  line  by  checking 
the  flag  word  in  sector  0  of  the  revector  control  table.  If 
replacement  needs  to  be  completed,  RCT  completes  the  bad  block 
replacement . 
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5.7  PREVENTING  LOSS  OF  WRITE-BACK  CACHE  DATA 

RCT  prevents  loss  of  write-back  cache  data. 

A  disk  with  the  write-back-cache-in-use  flag  set  will  be  write-locked 
each  time  it  is  brought  on  line.  To  write-enable  such  a  disk,  use  the 
/WRITE  qualifier  with  the  MCR  MOUNT  command  each  time  you  mount  the 
disk.  RCT  checks  the  write-back-cache-in-use  flag  word  in  sector  0  of 
the  revector  control  tables,  software  write-locks  the  disk  if  the  flag 
is  set,  and  writes  the  following  TKTN  message  to  the  console  output 
device  (CO : ) : 

ddnns  —  Write  back  caching  data  lost.  Unit  write  locked 
where  ddnn:  is  the  disk  that  RCT  has  write  locked. 

NOTE 

Because  RSX-11M  and  RSX-11M-PLUS  operating  systems  do 
not  support  disks  with  write-back  caching,  this 
function  is  extremely  rare. 

RCT  performs  this  function  only  under  the  following  circumstances: 

1.  A  disk  with  a  write-back  cache  failed  to  copy  the  data  from 
the  write-back  cache  to  the  disk  before  going  off  line,  while 
on  another  operating  system  (that  supports  write-back 
caching) ,  and  was  then  moved  to  an  RSX-11M  or  RSX-11M-PLUS 
operating  system. 

2.  The  revector  control  tables  have  been  altered  such  that  the 
write-back-cache-in-use  flag  is  set. 


5.8  RCT  AND  OTHER  RSX11M  AND  RSX-11M-PLUS  UTILITIES 

Utilities  such  as  BAD,  BRU,  and  INI  treat  MSCP  devices  as 
non- last- track  devices.  RCT  does  not  replace  the  BAD  utility.  You 
must  run  BAD  on  MSCP  devices  to  create  a  bad  block  descriptor  file 
before  you  initialize  the  disk.  You  can  use  BAD  to  find  bad  blocks 
and  list  them  in  a  bad  block  descriptor  file.  However,  the  bad  block 
descriptor  file  will  not  contain  any  information  about  blocks  detected 
by  the  device  controller  and  replaced  by  RCT. 


5.9  RCT  AND  THE  ERROR  LOGGER 

DUDRV  notifies  the  Error  Logger  with  an  error  log  packet  whenever  an 
error  has  been  detected  that  requires  bad  block  replacement.  RCT  also 
generates  an  error  log  packet  indicating  that  a  bad  LBN  has  been 
successfully  (or  unsuccessfully)  replaced  by  an  RBN .  RCT  logs  the 
packet  under  the  name  of  the  task  that  issued  the  QIO  resulting  in  the 
detection  of  the  bad  block  by  the  controller. 
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RESOURCE  MONITORING  DISPLAY  (RMD) 


The  Resource  Monitoring  Display  (RMD)  is  a  privileged  task  that 
displays  information  about  the  resources  in  your  system.  This 
information  includes  the  active  tasks,  their  location  in  memory,  the 
amount  of  memory  they  occupy,  and  the  available  pool  space.  On  video 
terminals  such  as  VT52s,  VTlOO-series ,  VT200-series ,  and  Professional 
series  terminals,  RMD  provides  dynamic  displays.  On  hardcopy 
terminals  such  as  LA180s,  RMD  provides  "snapshot"  displays.  RMD 
alters  the  display  format  according  to  terminal  type  without  your 
having  to  set  switches  or  rebuild  the  task. 


6 . 1  INTRODUCTION 

RMD  consists  of  "pages".  A  page  consists  of  24  lines,  which,  on  CRT 
terminals,  is  one  screen.  The  program  contains  two  kinds  of  pages: 
display  pages  and  setup  pages . 


6.1.1  Display  Pages 

There  are  four  display  pages  available  on  both  RSX-11M  and 
RSX-1 1M-PLUS  systems: 

•  Memory  (M) 

•  Active  Task  List  (A) 

•  Task  Header  (T) 

•  Help  (H) 

There  are  four  additional  display  pages  that  are  available  only  on 
RSX-1 1M-PLUS  and  Micro/RSX  systems: 

•  I/O  Counts  (I) 

•  System  Statistics  (S) 

•  General  Statistics  about  a  Cache  Region  (C) 

•  Detailed  Statistics  about  a  Cached  Device  (D) 

You  press  the  terminal  keys  indicated  in  parentheses  to  switch  display 
pages . 


RESOURCE  MONITORING  DISPLAY  (RMD) 


6.1.2  Setup  Pages 

There  are  five  setup  pages.  Each  setup  page  is  associated  with  a 
display  page.  (The  Help  Display  Page  has  no  associated  setup  page.) 
You  access  a  setup  page  from  a  display  page  by  pressing  the  ESCAPE  key 
on  your  terminal.  The  setup  page  documents  and  prompts  you  for  setup 
commands,  which  alter  the  content  of  the  information  displayed  on  the 
associated  display  page. 


6.2  INSTALLING  AND  INVOKING  RMD 

Individual  users  can  invoke  RMD  at  their  terminals.  For  large  systems 
that  support  many  terminals,  you  may  want  to  run  RMD  continuously  on  a 
slaved  terminal  near  the  computer.  You  use  different  procedures  to 
install  and  invoke  RMD  for  use  by  individual  users  and  to  run  RMD  on  a 
slaved  terminal . 


6.2.1  Using  RMD  at  Individual  Terminals 

On  RSX-11M  systems,  RMD  is  available  if  you  selected  RMD  at  system 
generation. 

On  RSX— 11M— PLUS ,  RMD  is  always  available. 


6. 2. 1.1  Installing  RMD  at  Individual  Terminals  -  You  must  install  RMD 
in  order  for  non-privileged  users  to  use  it.  Privileged  users  can 
simply  use  the  MCR  RUN  command  to  run  $RMD .  To  install  RMD,  use  the 
MCR  INSTALL  command  at  a  privileged  terminal: 

> I M S  $RMD 


6. 2. 1.2  Invoking  RMD  at  Individual  Terminals  -  From  any  terminal,  you 
invoke  an  installed  copy  of  RMD  from  MCR  as  follows: 

>  R 11  n  T. p a 3 e  1  C  f  set u p c o m m a n d s  3  ♦  ♦  * 


where: 

page 

One  of  the  display  page  abbreviations  (M,  A,  T,  or  H) .  (There 
are  also  I,  S,  C,  and  D  pages  for  RSX-11M-PLUS  users.)  The 
default  page  is  the  Memory  Display  (M) . 

setupcommands 

A  valid  setup  command  for  the  display  page  that  you  have 
selected.  The  setup  commands  are  the  same  as  those  available  to 
you  from  the  setup  page  associated  with  the  display  page  you 
specified.  The  default  setup  commands  are  discussed  in  Sections 
6.4  through  6.6,  which  describe  the  content  of  each  display  page 
and  how  you  use  setup  commands  to  alter  display  parameters. 

From  a  privileged  terminal  only,  you  can  invoke  an  uninstalled  copy  of 
RMD  using  the  MCR  RUN  command.  However,  MCR  command  line  parsing  is 
available  only  if  RMD  is  installed. 
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6.2.2  Running  RMD  on  a  Slaved  Terminal 

To  run  RMD  on  a  slaved  terminal  and  also  allow  users  to  invoke  RMD  at 
their  own  terminals,  RMD  must  be  installed  twice  using  different  task 
image  files  and  different  task  names. 

On  RSX-11M  systems,  if  you  selected  RMD  at  system  generation,  you  will 
find  RMD.TSK  (which  has  been  task  built  at  system  generation  with  task 
name  ...RMD)  in  SYSUIC  on  your  system  disk. 

On  RSX-1 1M-PLUS  systems,  you  will  find  RMD.TSK  (which  has  been  task 
built  at  system  generation  with  task  name  ...RMD)  in  SYSUIC  on  your 
system  disk. 

RMD.TSK  is  the  copy  of  RMD  that  the  system  installs  for  individual 
users  to  invoke.  LUNs  1  and  2  in  this  task  image  have  been  assigned 
to  TI:  so  that  a  user  at  any  terminal  can  invoke  RMD. 

To  run  RMD  on  a  slaved  terminal,  do  the  following: 

1.  From  a  privileged  terminal,  make  a  copy  of  RMD.TSK  in  SYSUIC 
on  your  system  disk  named  RMDEMO.TSK.  If  your  SYSUIC  is 
[1,54]  and  your  system  disk  is  DRO:,  use  the  following 
command  sequence: 

>  SET  /REF* Cl *543 

>  ASM  dropsy: 

>  PIP  RMDEMO ♦ TSK- RMD ♦ TSK 

2.  From  a  privileged  terminal  or  from  a  command  file  to  be  executed 
at  a  privileged  terminal,  install  RMDEMO  using  the  following  command 
sequence : 

>  INS  RMDEMO/T  ASK-RMDFMO 

>  REA  RMDEMO  1  it  nr.: 

>  REA  RMDEMO  2  ttnni 
SET  /$LAVE~ttnn  t 

>  RUN  RMDFMO 

where  ttnn :  is  the  terminal  at  which  you  want  to  run  RMDEMO. 

This  command  sequence  installs  RMD  with  task  name  RMDEMO, 
reassigns  LUNs  1  and  2  to  the  terminal  you  want  to  slave  to 
the  task,  slaves  the  terminal,  and  invokes  the  task. 

Because  the  REASSIGN  command  alters  the  task  image  on  disk, 
you  must  use  two  task  images  rather  than  simply  installing 
RMD  twice  with  different  task  names. 


6.3  THE  HELP  DISPLAY 

The  Help  Display  documents  how  you  switch  display  pages .  You  switch 
display  pages  by  pressing  a  terminal  key  as  follows: 

Key  Explanation 

M  Accesses  the  Memory  Display 

A  Accesses  the  Active  Task  Display 

T  Accesses  the  Task  Header  Display 

I  Accesses  the  I/O  Counts  Display 

S  Accesses  the  System  Statistics  Display 

C  Accesses  the  General  Statistics  about  a  Cache  Region 

D  Accesses  the  Detailed  Statistics  about  a  Cached  Device 
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The  Help  Display  also  documents  how  to  exit  from  RMD  and  use  the 
ESCAPE  key  to  access  setup  pages  from  their  associated  display  pages. 
(Because  there  is  nothing  to  alter  on  the  Help  Display,  no  setup  page 
is  available  from  the  Help  Display. ) 

The  Memory,  Active  Task,  and  Task  Header  Displays  use  the  entire 
screen.  Therefore,  you  receive  no  prompts  or  documentation  on  display 
pages.  To  find  out  how  to  access  a  setup  page  from  a  display  page  or 
how  to  switch  display  pages,  press  the  H  key  (for  Help)  to  access  the 
Help  Display. 


6.4  THE  MEMORY  DISPLAY 

The  Memory  Display  graphically  represents  the  entire  system  memory, 
including  the  approximate  size  and  locations  of  partitions  and  active 
tasks.  The  display  also  shows  pool  statistics,  the  name  of  the  task 
that  is  currently  executing,  and  other  information  about  the  status  of 
your  operating  system.  You  access  the  Memory  Display  from  another 
display  page  by  pressing  the  M  key  (for  Memory).  To  access  the  Memory 
Display  from  the  MCR  command  line,  you  type  the  following: 

>RMD  M 

If  you  invoke  RMD  without  specifying  a  display  page: 


>  R  H  D 

RMD  defaults  to  the  Memory  Display. 


Figures  6-1  and  6-2  show  "snapshots"  of  the  Memory  Display  for  RSX-11M 
and  RSX-1 1M-PLUS  respectively.  The  reverse  numbers  in  each  figure 
(white  numbers  in  black  circles)  match  the  reverse  numbers  in  the 
explanations  that  follow  the  two  figures.  Where  a  display  field  is 
the  same  for  both  RSX-11M  and  RSX-11M-PLUS ,  it  is  designated  by  the 
same  reverse  number  in  Figures  6-1  and  6-2.  The  matching  explanation, 
however,  appears  only  once. 
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Figure  6-1  RSX-11M  Memory  Display 
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Figure  6-2  RSX-11M-PLUS  Memory  Display 


O  Operating  system  type,  version  number,  and  base  level. 

0  Six-character  name  that  is  a  DECnet  node  name  (if  DECnet  is 
running  on  your  system)  or  the  system  name  that  you  selected  in 
SYSGEN  (if  DECnet  is  not  running  on  your  system). 

0  Size  in  K  words  of  the  system  memory. 

0  For  RSX-11M-PLUS  systems,  time  elapsed  in  units  of  days,  hours, 
and  minutes,  since  the  system  was  last  bootstrapped. 

0  Current  date  and  time. 

0  Name  of  the  task  that  is  currently  executing  or,  if  none  is 
executing,  *IDLE*  (Executive  executing  the  idle  loop). 

0  Number  of  free  blocks  on  the  first  four  Files-11  devices  in  your 
system.  If  a  device  is  dismounted,  RMD  displays:  "DMO" .  If  a 
device  is  off  line,  RMD  displays:  "OFL".  Magnetic  tapes  can 

also  be  displayed,  but  only  if  previously  selected  from  the  I 
setup  page. 

©  Pool  (dynamic  storage  region)  information  in  the  format: 

POOL=X:Y:Z 


where : 

X  Number  of  words  in  the  largest  free  block  in  pool 

Y  Number  of  free  words  in  pool 

Z  Number  of  fragments  in  the  pool  free  list 

The  second  line  records  the  worst  case  of  pool  since  you  invoked 
RMD.  This  line  is  most  useful  if  RMD  has  been  running  on  a 
slaved  terminal  since  the  system  was  last  booted. 
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0  On  RSX-11M-PLUS  systems,  secondary  pool  information  in  the 
following  format: 

SECPOOL=A:B:C% 

where : 

A  Number  of  free  blocks  in  secondary  pool 

B  Total  number  of  blocks  in  secondary  pool 

C%  Percentage  of  secondary  pool  that  is  free 

The  second  line  records  the  worst  case  of  secondary  pool  since 
you  invoked  RMD.  This  line  is  most  useful  if  RMD  has  been 
running  on  a  slaved  terminal  since  the  system  was  last 
bootstrapped . 

©  Partitions  in  the  system  using  the  following  format: 
partitionname : type 
where : 
type 


For  RSX-11M  systems  (Figure  6-1),  one  of  the  following: 

T  Task  partition 
S  Subpartition 

D  System-controlled  (dynamic)  partition 
C  Common  partition 

For  RSX-11M-PLUS  systems  (Figure  6-2),  one  of  the  following: 

D  System-controlled  (dynamic)  partition 
P  Secondary  pool  partition 

Number  of  tasks  in  memory  and  amount  of  memory  they  use,  and 
number  of  active  tasks  swapped  or  checkpointed  out  of  memory  and 
the  amount  of  memory  they  would  require. 


©  Name  of  each  task,  common,  or  driver  in  memory  and  its  location 
in  memory  using  the  following  symbols  to  designate  size,  type 
(task,  common,  or  driver),  and  other  attributes: 

Symbol  Attribute 


<  > 

C  ] 

l  l 

+  + 

(  ) 


Active  task 

Task  not  active,  yet  occupies  memory 
Named  common 

Unnamed  common  (displayed  name  is  first  attached 
task) 

Loaded  driver  using  device  mnemonic 
Task  not  fixed  in  memory 
Task  fixed  in  memory 


The  hyphens  and  equal  signs  represent  the  approximate  amount  of 
memory  that  each  task,  driver,  or  common  occupies.  Where  the 
display  shows  only  one  delimiter  and  no  hyphens  or  equal  signs, 
the  open  delimiter  is  in  the  same  location  as  the  closing 
delimiter  of  the  preceding  task. 
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0  Partition  size  and  location.  The  beginning  of  each  partition  is 
marked  with  the  same  symbols  as  those  listed  previously  plus  the 
following  additions  for  both  operating  systems: 

E  Executive 
P  Pool 

The  lines  of  asterisks  are  approximate  representations  of  the 
amount  of  memory  occupied  by  each  partition.  The  numbers  are  in 
IK  word  increments.  Each  numerical  character  also  represents  the 
same  amount  of  memory  as  an  asterisk.  RMD  always  divides  the 
system  memory  into  groups  of  eight  units . 

0  System  error  count  sequence  recorded  by  the  Error  Logger  (always 
zero  if  Error  Logger  not  present  in  your  system) . 


6.4.1  Altering  the  Memory  Display  from  the  Setup  Page 

To  alter  the  Memory  Display,  you  press  the  ESCAPE  key,  which  accesses 
the  setup  page  for  the  Memory  Display.  The  setup  page  documents  and 
prompts  you  for  commands  which  you  use  to  alter  the  Memory  Display. 
You  can  enter  multiple  commands  after  each  prompt  by  using  commas  as 
separators .  The  setup  commands  available  for  altering  the  Memory 
Display  are  as  follows: 

•  FREEx=ddnn:,  where  x  is  a  number  from  0  to  3  and  ddnn:  is  a 

device  name  and  number 

•  RATE=s,  where  s  is  the  replot  rate  in  seconds 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  stay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Memory  Display. 


6. 4. 1.1  The  FREE  Command  -  You  use  this  command  to  determine  the  four 
Files-11  devices  for  which  you  want  the  Memory  Display  to  show  the 
available  free  blocks.  This  information  is  (7)  in  both  Figures  6-1 
and  6-2.  The  default  is  your  system  disk  (SY:)  and  the  next  three 
Files-11  devices  in  your  configuration. 


6. 4. 1.2  The  RATE  Command  -  You  use  this  command  to  determine  how 
often  RMD  replots  the  Memory  Display  if  you  are  running  RMD  on  a  CRT. 
The  default  replot  rate  is  once  per  second. 


6.4.2  Altering  the  Memory  Display  from  the  MCR  Command  Line 

You  can  enter  the  FREE  and  RATE  commands  as  part  of  the  MCR  command 
line.  (The  general  format  of  the  MCR  command  line  is  discussed  in 
Section  6. 2. 1.2.)  For  example,  when  you  enter  the  MCR  command  line 

>RMD  M >  FRFE3«DM0 t  > RATE-3 

RMD  displays  the  number  of  free  blocks  on  DMO:  instead  of  the  fourth 
Files-11  device  in  your  configuration  and  replots  the  display  every  3 
seconds  instead  of  every  second. 
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To  change  the  second  and  third  Files-11  devices  to  DB1 :  and  DB2 : 
respectively,  use  the  following  MCR  command  line: 

>RMD  MfFREEl=DBi: * FREE2»DB2t 

These  setup  parameters  stay  in  effect  until  you  alter,  them  by  using 
setup  commands  from  the  setup  page.  Even  if  you  switch  to  another 
display  page  and  back  to  the  Memory  Display,  RMD  does  not  restore  the 
default  setup  parameters. 

Other  display  pages  allow  you  to  select  devices  as  well.  These 
devices  are  common  across  all  pages.  Therefore,  if  you  select  F1=DM0: 
for  the  M  page,  and  then  switch  to  the  I  page,  DMO:  will  be  the  first 
displayed  device,  not  SY:  (which  would  be  the  default). 


6.5  THE  ACTIVE  TASK  DISPLAY 

The  Active  Task  Display  shows  you  the  active  tasks  in  the  system.  You 
access  this  display  from  another  display  page  by  pressing  the  A  key 
(for  Active  Task).  To  access  this  display  from  the  MCR  command  line, 
you  type  the  following: 

>RMD  A 

This  display  has  six  fields: 

1.  Name  of  the  task 

2 .  Length  of  the  task  in  octal  bytes 

3.  Terminal  that  issued  the  task 

4.  Running  priority  of  the  task 

5.  Outstanding  I/O  count 

6.  Status  flags 

The  status  flags  use  the  same  mnemonics  as  the  MCR  ATL  command.  See 
the  RSX-11M/M-PLUS  MCR  Operations  Manual  for  the  definitions  of  the 
status  flags. 


6.5.1  Altering  the  Active  Task  Display  from  the  Setup  Page 

To  alter  the  Active  Task  Display,  you  press  the  ESCAPE  key,  which 
displays  the  setup  page  for  the  Active  Task  Display.  The  setup  page 
documents  and  prompts  you  for  commands  that  you  use  to  alter  the 
Active  Task  Display.  You  can  enter  multiple  commands  after  each 
prompt  by  using  commas  as  separators.  The  setup  commands  available 
for  altering  the  Active  Task  Display  are  as  follows: 

•  OWNER=ttnn:  -  Where  ttnn:  is  the  terminal  that  issued  the 
task . 

The  OWNER  command  allows  RMD  to  display  only  those  tasks  that 
have  been  issued  by  a  particular  terminal.  The  default  is 
ALL,  which  displays  tasks  issued  from  all  terminals. 
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•  PRIORITY-p  -  Where  p  is  a  task's  running  priority. 

The  active  task  list  may  be  too  long  to  fit  on  one  screen. 
You  use  the  PRIORITY  command  to  determine  the  highest  priority 
tasks  that  you  want  to  see.  The  default  is  250,  the  highest 
possible  priority. 

•  RATE=s  where  s  is  the  replot  rate  in  seconds • 

The  RATE  command  allows  you  to  determine  how  often  RMD  replots 
the  Active  Task  Display,  if  you  are  running  RMD  on  a  CRT.  The 
default  replot  rate  is  once  per  second. 

•  TASK=taskname  -  Where  taskname  is  the  name  of  the  task  whose 
header  you  want  to  display. 

The  TASK  command  allows  you  to  look  at  a  specific  task  header. 
This  command  is  an  exception  because  it  is  the  only  setup 
command  that  switches  display  pages.  There  is  no  default  for 
the  TASK  command.  The  Task  Header  Display  is  discussed  in 
Section  6.6. 


You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  stay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Active  Task  Display. 


6.5.2  Altering  the  Active  Task  Display  from  the  MCR  Command  Line 

You  can  enter  the  same  setup  commands  discussed  in  the  previous 
section  as  part  of  the  MCR  command  line.  For  example,  when  you  enter 
the  MCR  command  line: 

> ft M R  A » ft ft r  0 R I T Y  =  200  *  RATF « 3 

RMD  displays  the  Active  Task  Display  using  200  as  the  maximum  task 
priority  and  replots  the  display  every  3  seconds. 

To  display  only  those  tasks  issued  by  your  terminal,  type  the 
following: 

> ft h 0  A  9  OWNER- T I : 


6.6  THE  TASK  HEADER  DISPLAY 

The  Task  Header  Display  shows  you  the  task  header  of  the  task  you 
specify.  You  access  this  display  from  another  display  page  by 
pressing  the  T  key  (for  Task  Header) •  If  no  task  is  currently 
specified,  RMD  shows  you  the  setup  page  first  so  that  you  can  specify 
the  task  whose  task  header  you  want  RMD  to  display. 

To  access  the  Task  Header  Display  from  the  MCR  command  line,  you  type 
the  following: 


>  R  M  D  T  r  T  A  S  K  - 1  a  s  k  n  a  m  e 

where  taskname  is  the  name  of  the  task  whose  header  you  want  RMD  to 
display. 
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If  you  invoke  RMD  from  the  MCR  command  line  without  specifying  the 
name  of  a  task: 

>  R  H  D  T 

RMD  displays  the  setup  page  first  so  that  you  can  specify  the  name  of 
the  task  whose  header  you  want  RMD  to  display. 

The  Task  Header  Display  shows  you  the  following  information  about  the 
specified  task: 

•  Name  of  the  task 

•  Name  of  the  partition  in  which  the  task  runs 

•  Status  flags,  which  have  the  same  mnemonics  as  in  the  Active 
Task  display 

•  Owner  of  the  task  by  terminal  number 

•  Outstanding  I/O  count 

•  Default  priority 

•  Running  priority 

•  Swapping  priority 

•  Length  in  decimal  words 

•  Contents  of  the  six  general  purpose  registers,  the  program 
counter,  and  the  Processor  Status  Word 

•  Contents  of  the  Directive  Status  Word  ($DSW) 

•  Local  event  flags 

•  Logical  unit  number  (LUN)  assignments  to  a  maximum  of  26  LUNs 

When  RMD  displays  file  names  in  the  list  of  LUN  assignments,  the  file 
name  is  the  name  of  the  file  when  it  was  created.  If  the  file  has 
been  renamed,  the  RMD  display  will  not  reflect  the  current  file  name. 


6.6.1  Altering  the  Task  Header  Display  from  the  Setup  Page 

To  alter  the  Task  Header  Display,  you  press  the  ESCAPE  key,  which 
displays  the  setup  page  for  the  Task  Header  Display.  The  setup  page 
documents  and  prompts  you  for  commands  that  alter  the  Task  Header 
Display.  You  can  enter  multiple  qommands  after  each  prompt  by  using 
commas  as  separators.  The  setup  commands  available  for  altering  the 
Task  Header  Display  are  as  follows: 

•  RATE=s  -  Where  s  is  the  replot  rate  in  seconds . 

The  RATE  command  allows  you  to  determine  how  often  RMD  replots 
the  Task  Header  Display  if  you  are  running  RMD  on  a  CRT.  The 
default  replot  rate  is  once  per  second. 

•  TASK=taskname  -  Where  taskname  is  the  name  of  the  task  whose 
header  you  want  to  display. 
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The  TASK  command  changes  the  task  header  to  be  displayed. 
There  is  no  default.  The  TASK  command  has  the  same  function 
as  the  TASK  command  on  the  Active  Task  Display,  except  that 
here  it  does  not  switch  display  pages . 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  remain  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Task  Header  Display. 


6.6.2  Altering  the  Task  Header  Display  from  the  MCR  Command  Line 

Both  the  RATE  and  TASK  commands  are  available  to  you  from  the  MCR 
command  line.  If  you  invoke  RMD  using  the  following  command  line: 

>  RMD  T  i  RATF.-2  *  TASK-  ♦  ♦  ♦  FDT 

RMD  displays  the  Task  Header  Display  for  EDT,  replotting  the  page 
every  2  seconds.  You  must  give  the  full  task  name.  In  this  case  the 
taskname  is  "...EDT",  not  "EDT". 

If  you  do  not  specify  a  task  name  in  the  MCR  command  line: 

> RMD  T  r  RATE  =  2 

RMD  first  displays  the  setup  page  so  that  you  can  select  a  task  whose 
header  you  want  RMD  to  display.  The  replot  rate  will  be  set  to  2 
seconds . 


6.7  DISPLAYS  AVAILABLE  ONLY  ON  RSX-11M-PLUS 

Four  displays  are  available  only  on  RSX-11M-PLUS  systems:  the  I/O 
Counts  Display,  the  System  Statistics  Display,  the  General  Statistics 
about  a  Cache  Region  Display,  and  the  Detailed  Statistics  for  a  Cached 
Device  Display.  These  displays  are  invoked  by  the  commands  RMD  I,  RMD 
S,  RMD  C  and  RMD  D,  respectively. 


6.7.1  The  I/O  Counts  Display 

The  I/O  Counts  display  shows  you  I/O  and  error  logging  counts  for  up 
to  six  error  logging  devices.  By  default,  the  first  six  error  logging 
disk  devices  in  your  hardware  configuration  are  displayed.  You  access 
this  display  from  another  display  by  pressing  the  I  key  (for  I/O) .  To 
access  this  display  from  the  MCR  command  line,  you  type  the  following: 

>  RMD  1 

The  I/O  Counts  Display  has  10  fields  for  each  device: 

1 .  Device  name  of  the  displayed  device 

2.  Total  number  of  I/O  requests  to  the  device 

3.  Number  of  I/O  requests  issued  to  the  device  in  the  last 
second 

4.  Average  number  of  I/O  requests  issued  to  the  device  per 
second 
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5.  Average  number  of  cylinders  crossed  per  I/O  request  during 
the  last  second 

6.  Average  number  of  cylinders  crossed  per  I/O  request 

7.  Number  of  words  transferred  during  the  last  second 

8.  Average  number  of  words  transferred  per  second 

9.  Count  and  limit  of  soft  I/O  errors 

10.  Count  and  limit  of  hard  I/O  errors 

The  I/O  Counts  display  works  only  on  video  terminals. 


6. 7. 1.1  Altering  the  I/O  Counts  Display  from  the  Setup  Page  -  To 
alter  the  I/O  Counts  Display,  you  press  the  ESCAPE  key,  which  displays 
the  setup  page  for  the  I/O  Counts  Display.  The  setup  page  lists  the 
available  commands  you  can  use  to  alter  the  I/O  Counts  Display,  and 
prompts  you  for  a  command.  You  can  enter  multiple  commands  after  each 
prompt  by  using  commas  as  separators.  The  setup  commands  available 
for  altering  the  I/O  Counts  Display  are  as  follows: 

•  DEVICEx=ddnn:  -  Where  x  is  a  number  from  0  to  6  and  ddnn:  is 
an  error  logging  device. 

The  DEVICE  command  allows  you  to  select  which  error  logging 
devices  are  to  be  displayed.  The  device  specified  must  be  an 
error  logging  device.  You  may  select  magnetic  tape  devices 
from  the  setup  page.  For  magnetic  tape  devices,  fields  5  and 
6  are  suppressed.  If  you  do  not  use  the  DEVICE  command  to 
specify  a  device  or  devices,  the  first  six  error  logging  disk 
devices  in  your  hardware  configuration  are  displayed  by 
default.  See  the  RSX-11M/M-PLUS  Error  Logging  Manual  for  a 
list  of  the  error  logging  devices. 

•  RATE=s  -  Where  s  is  the  replot  rate  in  seconds . 

The  RATE  command  allows  you  to  determine  how  often  RMD  replots 
the  I/O  Counts  Display,  if  you  are  running  RMD  on  a  video 
display  terminal.  The  default  replot  rate  is  once  per  second. 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  stay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  then  return  to  the  I/O  Counts 
Display. 


6. 7. 1.2  Altering  the  I/O  Counts  Display  from  the  MCR  Command  Line  - 
You  can  enter  the  DEVICE  and  RATE  commands  as  part  of  the  MCR  command 
line.  For  example,  when  you  enter  the  following  command  line,  RMD 
displays  I/O  count  information  for  DB3 :  and  replots  the  display  every 
2  seconds: 

>  RMI*  I ,  r»FMICF2«RR3  t > RATE»2 

The  information  for  DR3 :  is  displayed  in  the  position  that  would 
normally  display  information  for  the  third  error  logging  device  in 
your  hardware  configuration. 
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To  change  the  first  and  second  device  display  positions  to  DB1 :  and 

DB2:,  respectively,  use  the  following  MCR  command  line; 

>RMO  If  BCMICEO*OBt *  f DEVICE 1 -DB2 ♦ 

These  setup  parameters  stay  in  effect  until  you  alter  them  by  using 
setup  commands  from  the  setup  page.  Even  if  you  switch  to  another 
display  page,  and  then  return  to  the  I/O  Counts  Display,  RMD  does  not 
restore  the  default  parameters. 


6.7.2  The  System  Statistics  Display 

The  System  Statistics  Display  shows  you  general  information  about  the 
operation  of  your  system.  Much  of  this  information  comes  from 
RSX-11M-PLUS  Resource  Accounting,  so  this  display  is  only  useful  if 
Resource  Accounting  was  included  when  your  system  was  generated.  You 
access  this  by  pressing  the  S  key.  To  access  this  display  from  the 
MCR  command  line,  you  type  the  following: 

>RHP  S 

The  display  has  25  fields. 

1.  Total  number  of  tasks  run 

2 .  Number  of  currently  active  tasks 

3.  Total  number  of  user  logons 

4.  Number  of  users  currently  logged  on 

5.  Total  number  of  runs  of  the  shuffler 

6 .  Error  sequence  count 

7 .  Pool  information  ( in  the  same  format  as  in  the  Memory 
Display) 

8.  Secondary  pool  information  (in  the  same  format  as  in  the 
Memory  Display) 

9.  Percentage  of  system  memory  used 

10.  Percentage  of  system  checkpoint  files  used 

11.  Total  number  of  directives  issued 

12.  Number  of  directives  issued  during  the  last  second 

13.  Average  number  of  directives  issued  per  second 

14.  Total  number  of  QIOs  issued 


15.  Number  of  QIOs  issued  during  the  last  second 

16.  Average  number  of 

:  QIOs  issued  per 

second 

17.  Total  number 

of  I 

•unning  CPU  ticks 

18.  Number  of  running 

r  CPU  ticks  during 

the  last  second 
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19.  Average  number  of  running  CPU  ticks  per  second 

20.  Total  number  of  zero  CPU  intervals 

21.  Number  of  zero  CPU  intervals  during  the  last  second 

22.  Average  number  of  zero  CPU  intervals  per  second 

23.  Total  number  of  task  checkpoints 

24.  Number  of  task  checkpoints  during  the  last  second 

25.  Average  number  of  task  checkpoints  per  second 


6. 7. 2.1  Altering  the  System  Statistics  Display  from  the  Setup  Page  - 
You  can  alter  the  replot  rate  on  the  System  Statistics  Display  by 
pressing  the  ESCAPE  key,  which  displays  the  setup  page  for  the  System 
Statistics  Display.  The  setup  page  lists  the  command  format  for 
altering  the  replot  rate,  and  prompts  you  for  a  command.  The  command 
for  altering  the  replot  rate  of  the  System  Statistics  Display  is  as 
follows : 

RATE=s,  Where  s  is  the  replot  rate  in  seconds. 

You  can  truncate  this  command  to  the  single  letter  R.  This  setup 
parameter  stays  in  effect  until  you  alter  it,  even  if  you  switch  to 
another  display  page  and  then  return  to  the  System  Statistics  Display. 

The  default  replot  rate  is  once  per  second. 


6. 7. 2. 2  Altering  the  System  Statistics  Display  from  the  MCR  Command 
Line  -  You  can  enter  the  RATE  command  as  part  of  the  MCR 
command  line.  For  example,  when  you  enter  the  following  MCR  command 
line,  RMD  replots  the  System  Statistics  Display  once  every  2  seconds: 

>  RMD  RATE-2 

This  setup  parameter  stays  in  effect  until  you  alter  it  by  using  the 
RATE=s  command  from  the  setup  page.  Even  if  you  switch  to  another 
display  page  and  then  return  to  the  System  Statistics  Display,  RMD 
does  not  restore  the  default  replot  rate. 


6.7.3  The  General  Statistics  About  a  Cache  Region  Display 

The  General  Statistics  about  a  Cache  Region  display  (RMD  C  display) 
shows  you  general  statistics  about  a  particular  cache  region. 
(However,  you  must  have  previously  established  disk  data  caching 
through  the  MOUNT  or  SET  command  to  use  this  display.  For  more 
information  on  disk  data  caching,  see  Chapter  19  of  this  manual.)  You 
access  this  display  from  another  display  by  pressing  the  C  key  (for 
Cache  Region).  To  access  this  display  from  the  MCR  command  line,  you 
type  the  following: 

>  RMD  C 


3 
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The  RMD  C  Display  has  14  fields  for  each  regions 

1.  Name  of  the  cache  region. 

2.  Region  size  in  octal  of  the  cache  region  in  32  word  memory 
blocks,  followed  in  parentheses  by  the  decimal  number  of  disk 
blocks  available  in  the  cache  extent  area. 

3.  Device  name. 

4.  Total  count  of  all  reads  issued  to  that  device.  These 
include  VIRTUAL,  READAHEAD,  DIRECTORY,  LOGICAL,  and  OVERLAY 
read  requests . 

5.  Read  hit  rate  (percentage  of  all  read  requests  that  were 
satisfied  by  the  cache) . 

6.  Read  fail  rate  (percentage  of  all  read  requests  that  could 
not  be  satisfied  by  the  cache). 

7.  Read  load  rate  (percentage  of  all  read  requests  that  resulted 
in  data  being  loaded  into  the  cache)  for  the  cache  region. 

8.  Total  writes  (count  of  all  write  requests  issued  to  the 
device,  including  VIRTUAL,  DIRECTORY,  and  LOGICAL  writes). 

9.  Write  hit  rate  (percentage  of  all  write  requests  that  caused 
updating  of  blocks  already  loaded  in  the  cache) . 

10.  Write  fail  rate  (percentage  of  all  write  requests  that  could 
not  be  directed  to  the  cache  because  of  an  extent  overlap) . 

11.  Write  defer  rate  (percentage  of  all  write  requests  that  were 
deferred) . 

12.  Total  I/O  operations  (total  of  all  read  and  write  operations 
for  the  device. 

13.  Cache  Used  (percentage  of  cache  extent  storage  area  used  by 
the  device) . 

14.  Totals  for  the  cache  region. 


6. 7. 3.1  Altering  the  RMD  C  Display  from  the  Setup  Page  -  To  alter  the 
Display,  you  press  the  ESCAPE  key,  which  displays  the  setup  page  for 
the  General  Statistics  about  a  Cached  Region  Display.  The  setup  page 
lists  the  available  commands  you  can  use  to  alter  the  Display,  and 
prompts  you  for  a  command.  You  can  enter  multiple  commands  after  each 
prompt  by  using  commas  as  separators.  The  setup  commands  available 
for  altering  this  display  are: 

•  REGION=name  specifies  the  region  to  be  displayed. 

This  command  allows  you  to  select  the  cache  region  to  be 
displayed.  The  default  region  is  CACHE. 

•  RATE=s ,  Where  s  is  the  refresh  rate  in  seconds. 

This  command  allows  you  to  determine  how  often  RMD  replots  the 
General  Statistics  about  a  Cache  Region  Display,  if  you  are 
running  RMD  on  a  video  display  terminal.  The  default  refresh 
rate  is  once  per  second. 
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You  can  truncate  these  commands  to  their  shortest  unique  forms.  (For 
this  display  page,  the  shortest  unique  form  is  RA  for  RATE,  and  RE  for 
REGION.)  These  setup  parameters  stay  in  effect  until  you  alter  them, 
even  if  you  switch  to  another  display  page  and  then  return  to  the  RMD 
C  Display. 


6. 7. 3. 2  Altering  the  RMD  C  Display  from  the  MCR  Command  Line  -  You 
can  enter  the  REGION  and  RATE  commands  as  part  of  the  MCR  command 
line.  For  example,  when  you  enter  the  following  command  line,  RMD 
displays  general  statistics  for  the  region  named  CACHE  and  replots  the 
display  every  2  seconds: 

> RHP  C  ?  REOT ON-CACHF  j  RATE-2 

The  information  displayed  is  for  the  region  named  CACHE  and  is 
refreshed  every  two  seconds. 

These  setup  parameters  stay  in  effect  until  you  alter  them  by  using 
setup  commands  from  the  setup  page.  Even  if  you  switch  to  another 
display  page,  and  then  return  to  the  RMD  C  Display,  RMD  does  not 
restore  the  default  parameters. 


6.7.4  The  Detailed  Statistics  About  a  Cache  Region  Display 

The  Detailed  Statistics  about  a  Cache  Region  display  (RMD  D  display) 
shows  you  detailed  statistics  about  a  particular  cache  region. 
(However,  you  must  have  previously  established  disk  data  caching 
through  the  MOUNT  or  SET  command  to  use  this  display.  For  more 
information  on  disk  data  caching,  see  Chapter  19  of  this  manual.)  You 
access  this  display  from  another  display  by  pressing  the  D  key  (for 
Detailed  Statistics.)  To  access  this  display  from  the  MCR  command 
line,  you  type  the  following: 

>  RMD  D 

The  RMD  D  Display  has  15  fields  for  each  cached  device: 

1 .  Region  Name 

2.  Region  Size  (in  octal,  measured  in  32  word  memory  blocks.) 

3.  Cache  Status  field  (whether  the  cache  is  ACTIVE  and/or 
ENABLED) .  ACTIVE  means  the  device  is  being  cached  through 
the  region?  ENABLED  means  that  the  device  will  automatically 
be  cached  when  it  is  mounted  (even  if  the  MOUNT  command  does 
not  explicitly  request  that  the  device  be  cached). 

4.  Requests  Being  Cached  field  (types  of  cache  I/O  operations 
enabled  for  the  device).  The  types  can  be  VIRTUAL  (VIR) , 
READAHEAD  ( RDH ) ,  DIRECTORY  (DIR),  LOGICAL  (LOG),  and  OVERLAY 
(OVR) . 

5.  Reads  section  (number  of  read  requests  issued  for  each  of  the 
I/O  types  listed  in  the  display,  as  well  as  the  total  of  aXl 
read  requests). 

6.  Read  Hit  Rate,  Read  Load  Rate,  Read  Overlap  Rate,  and  the 
Extent  Too  Big  rate  for  each  type  of  request.  Each  of  these 
rates  is  computed  as  a  percentage  of  the  total  number  of  read 
operations  for  the  particular  type  of  request. 
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7. 

8. 


10. 


11. 


12. 


13. 


14. 


15. 


Maximum  Extent  Size  for  each  of  the  I/O  types. 

Writes  section  shows  the  number  of  write  requests  issued  for 
fTafh  °f  the  1/0  fcypes  and  the  total  of  all  write  requests. 
^°te  that  READAHEAD  and  OVERLAY  write  requests  do  not  exist 
so  these  fields  are  blank. 

Write  Hit  Rate  and  Write  Overlap  Rate  for  each  type  of  I/O 
request.  Each  of  these  rates  is  computed  as  a  percentage  of 
the  total  number  of  write  operations  of  a  particular  type . 

Total  amount  of  each  type  of  I/O,  as  well  as  the  total  amount 
of  all  I/O. 

The  last  four  list  items  show  rates  that  are  not  accumulated 
by  I/O  type.  All  cache  I/O  requests  require  that  an  I/O 
packet  be  allocated  from  primary  pool. 

Primary  Pool  Allocation  Failure  Rate  (how  often  the 
allocation  cannot  be  done)  as  a  percentage  of  the  total 
number  of  I/Os  issued  for  that  device. 

Cache  Pool  Allocation  Failure  Rate  is  similar  to  the  failure 
rate  for  primary  pool  allocation,  except  that  allocation  from 
the  cache  pool  is  only  required  on  read  operations.  The  rate 
is  therefore  computed  as  a  percentage  of  the  total  number  of 
read  operations . 


Read  Load  Failure  Rate  is  the  percentage  of  all 
attempts  that  failed  because  of  an  I/O  error. 


cache  load 


Deferred  Write  Rate  is  the  rate  that  write  operations  were 
able  to  be  deferred.  This  is  computed  as  a  percentage  of  the 
total  number  of  write  operations . 


6. 7. 4.1  Altering  the  RMD  D  Display  from  the  Setup  Page  -  To  alter  the 
Display,  you  press  the  ESCAPE  key,  which  displays  the  setup  page  for 
the  Detailed  Statistics  About  A  Cached  Region  Display.  The  setup  page 
lists  the  available  commands  you  can  use  to  alter  the  Display,  and 
prompts  you  for  a  command.  You  can  enter  multiple  commands  after  each 
prompt  by  using  commas  as  separators.  The  setup  commands  available 
for  altering  this  display  are: 

•  DEVICEl=ddnn :  -  specifies  the  device  to  be  displayed. 

This  command  allows  you  to  select  the  device  to  be  displayed. 
The  default  device  is  SY:.  Note  that  you  can  only  display  one 
device. 

•  RATE=s,  Where  s  is  the  refresh  rate  in  seconds. 

This  command  allows  you  to  determine  how  often  RMD  replots  the 
Detailed  Statistics  about  a  Cache  Region  Display,  if  you  are 
running  RMD  on  a  video  display  terminal.  The  default  refresh 
rate  is  once  per  second. 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  stay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  then  return  to  the  RMD  D  Display. 
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6. 7. 4. 2  Altering  the  RMD  D  Display  from  the  MCR  Command  Line  -  You 
can  enter  the  DEVICE  and  RATE  commands  as  part  of  the  MCR  command 
line.  For  example,  when  you  enter  the  following  command  line,  RMD 
displays  detailed  statistics  for  DR3 :  and  replots  the  display  every  2 
seconds : 

>RMH  BfDFVICF.l*nR3t  ,RATE*2 

The  information  for  DR3 :  is  displayed. 

These  setup  parameters  stay  in  effect  until  you  alter  them  by  using 
setup  commands  from  the  setup  page.  Even  if  you  switch  to  another 
display  page,  and  then  return  to  this  display,  RMD  does  not  restore 
the  default  parameters. 


6.8  MODIFYING  THE  TASK-BUILD  COMMAND  FILE 

You  can  modify  the  task-build  command  file  to  change  the  defaults  for 
RMD. 

On  RSX-11M  systems ,  this  file  is  LB : [ 1 , 24 ]RMDBLD . CMD  for  mapped 
systems  and  LB; [1, 20] RMDBLD.CMD  for  unmapped  systems. 

On  RSX-11M-PLUS  systems,  this  file  is  LB: [1 , 24]RMDBLD .CMD. 


6 . 9  ERROR  MESSAGES 

RMD  generates  the  following  error  messages: 


RMD  -  Allocated  screen  buffer  too  small  for  this  device 

Explanation:  RMD  requires  more  internal  memory  to  display  the 
requested  display  on  the  type  of  terminal  on  which  you  are 
running  RMD. 

User  Action:  Rebuild  RMD  with  a  larger  screen  buffer  by 
modifying  the  task-build  command  file  as  discussed  in  Section 
6.8. 

RMD  -  Illegal  command  -  xxxxx 

Explanation:  You  entered  an  illegal  command  xxxxx  either  on  the 
MCR  command  line  or  in  response  to  the  C0MMAND>  prompt  on  a  setup 
page . 

User  Action:  Enter  the  correct  command  as  documented  in  this 
chapter. 


RMD  -  Page  does  not  exist 

Explanation:  You  requested  a  display  page  from  the  MCR  command 

line  that  does  not  exist. 

User  Action:  Enter  the  command  line  again  specifying  a  correct 
display  mnemonic. 
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RMD  -  Segment  'xxxxxx'  not  found 

Explanations  The  module  xxxxxx  was  not  found  in  the  task 
for  RMD.  This  denotes  an  error  in  how  RMD  was  task  built. 


image 


User  Actions  Check  that  RMD  has  been  built  with  all  the  required 
modules . 


RMD  -  Terminal  type  not  defined 

Explanations  The  operating  system  and  RMD  do  not  recognize  your 
terminal  type. 

User  Actions  Check  your  terminal  type  using  the  MCR  command 
SET  /TERM=TIs.  If  this  setting  is  incorrect,  use  the  MCR  SET 
command  to  correct  your  terminal  type  setting.  If  the  setting  is 
correct,  move  to  a  different  type  of  terminal. 


RMD  -  Terminal  type  not  set 


Explanations 
display  page 
set . 


You  did  not  build  RMD  to  display  the  requested 
on  the  type  of  terminal  to  which  your  terminal  is 


User  Actions  Determine  your  terminal  type  setting  using  the 
MCR  SET  /TERM=TIs  command.  If  this  setting  is  incorrect,  use 
the  MCR  SET  command  to  correct  your  terminal  type  setting.  If 
the  setting  is  correct,  move  to  a  different  type  of  terminal. 


RMD  -  Terminal  type  not  yet  supported 

Explanations  RMD  does  not  recognize  your  terminal  type. 


User  Actions  Determine  your  terminal  type  setting  using  the 
MCR  SET  /TERM=TI s  command.  If  this  setting  is  incorrect,  use 
the  MCR  SET  command  to  correct  your  terminal  type  setting.  If 
the  terminal  type  is  correct,  you  can  write  a  terminal 
characteristics  module  for  the  terminal  similar  to  the  one  in 
[14,10]V52CHA.MAC.  Then,  assemble  the  module,  include  the  new 
module  in  the  ODL  file  and  rebuild  RMD. 
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CHAPTER  7 


SETTING  UP  AND  RUNNING  THE  QUEUE  MANAGER 


This  chapter  is  directed  to  the  system  manager  or  operator  who  will  be 
setting  up  and  running  the  Queue  Manager  and  batch  processors  on  an 
RSX-11M  or  RSX-1 1M-PLUS  system.  Except  where  noted,  all  commands  in 
this  chapter  are  privileged. 


Most  RSX-1 1M/M-PLUS  systems  will  include  the  Queue  Manager  for  the 
convenience  of  multistream  line  printer  spooling. 


The  Queue 
and  batcl 
processing 
Manager. 

Manager  on  RSX-: 
i  processing, 
j,  but  you  cannoi 

L1M-PLUS  also  supports 
You  can  have  the  Queue 
t  have  batch  processing 

transparent  spooling 
Manager  without  batch 
without  the  Queue 

In  UFD  [1,2]  on  the  system  disk  (LB:),  you  will  find  the  file 
STARTUP . CMD .  This  file  includes  commands  for  setting  up  the  Queue 
Manager  on  a  standard  configuration.  This  sets  up  the  QMG  subsystem 
on  a  baseline  system  with  one  print  processor,  (and,  on  RSX-llM-PLUS 
systems,  one  batch  processor.)  The  information  in  the  present  chapter 
will  help  you  alter  STARTUP . CMD  to  set  up  a  Queue  Manager  tailored  to 
your  installation. 

This  chapter  consists  of  a  narrative  introduction  and  review  of  the 
process  of  setting  up  the  Queue  Manager  {and  batch  processors}  and 
detailed  descriptions  of  all  commands  to  the  Queue  Manager. 

The  queue  management  subsystem  consists  of  three  major  components  on 
RSX-11M.  (RSX-llM-PLUS  systems  have  a  fourth  major  component.)  The 
components  are  as  follows: 


1.  A  command  line  interpreter  (QMGCLI )  that  processes  both  print 
requests  and  queue  access  commands  as  described  in  the 
RSX-1 1M/M-PLUS  Batch  and  Queue  Operations  Manual .  QMGCLI 
communicates  with  the  Queue  Manager  by  sending  data  packets 
to  it . 

2.  The  Queue  Manager  (QMG)  that  controls  the  queueing  and 
dequeueing  of  print  jobs.  QMG  communicates  with  QMGCLI  and 
the  despooler  tasks  to  process  print  jobs. 
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On  RSX-1 1M-PLUS  systems  only,  QMG  also  controls  batch 
processing.  The  RSX-11M-PLUS  QMGCLI  accepts  batch  requests 
as  well  as  print  requests.  The  RSX-11M-PLUS  QMG  controls  the 
queueing  and  dequeueing  of  batch  jobs.  The  RSX-11M-PLUS  QMG 
also  includes  a  batch  processor  prototype  task,  BPR.  This 
task  creates  a  virtual  terminal  that  passes  commands  to  the 
batch  processor  and  to  a  system  CLI,  either  MCR  or  DCL,  or  a 
user— written  CLI •  (Note  that  QMGCLI  is  not  a  CLI  in  this 
sense.)  The  BPR  task  can  be  installed  as  many  as  16  times 
with  task  names  in  the  form  BAPnnn,  where  nnn  represents  one 
to  three  Radix-50  characters. 

3.  The  despool  prototype  task  (LPP)  that  attaches  a  device  and 
despools  print  jobs  to  it.  An  LPP  must  be  installed  for  each 
device  to  be  used  as  a  spool  device  with  the  task  name  ddn, 
where  dd  is  the  generic  device  name  and  n  is  the  unit  number. 
A  despool  device  is  a  device  under  the  control  of  QMG. 

4.  On  RSX-1 1M-PLUS  only,  the  source  files  in  SYO: [121,10]  make 
up  the  print  processor  task.  You  can  use  this  as  a  model  if 
you  wish  to  write  output  despoolers  for  your  applications. 


7.1  INTRODUCTION  AND  REVIEW 

The  following  narrative  explains  how  to  bring  QMG  into  your  system. 
Both  MCR  and  DCL  commands  are  included. 

This  can  be  done  interactively,  but  in  most  cases  you  will  include  it 
in  an  indirect  command  file  invoked  as  part  of  the  system’s  STARTUP 
procedures . 


NOTE 

On  RSX-1 1M-PLUS  systems  with  DCL  as  a  CLI,  the  DCL 
form  of  these  commands  can  be  used  on  both  MCR  and  DCL 
terminals.  This  is  for  compatibility  with 
RSX— 1 1M-PLUS  Version  1.0. 

Each  of  the  following  steps  includes  a  block  diagram  of  the  Queue 
Manager,  processors,  and  devices  as  they  exist  at  that  point  in  the 
procedure.  Those  parts  of  the  subsystem  brought  into  being  by  that 
step  are  shown  in  red. 
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1. 


Install  the  Queue  Manager, 
privileged  utility  tasks. 


It  will  be  found  with  the 


DCL> INSTALL /CHECKPOINT  $QHG 


MCR> INSTALL  $GMG/CKP= YES 


QUEUE 

MANAGER 

stopped 


LPO: 

unspooled 


PRINTS 

.PRINT 


FCS 


>  SUBMIT 


>  PRINT 

ZK-1 54-81 
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Start  QMG.  The  command  starts  the  Queue  Manager  and 
initializes  the  default  queues  PRINT  and  BATCH.  It  creates 
the  queue  file  on  LBO:  if  the  file  is  not  there.  The 
command  also  clears  all  assignments  previously  recorded.  If 
the  queue  file  was  intact,  all  queues  will  still  contain 
their  jobs,  but  the  jobs  are  not  assigned  to  processors. 
(Processors  will  have  to  be  reinitialized,  but  queues  will 
not . ) 


DCL>  START /QUFIJF/M AN AGFR 

mcr>Que  /stasqhg 


QUEUE 

MANAGER 


LPO: 

unspooled 


>  SUBMIT 
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3.  The  default  print  queue  PRINT  was  initialized  in  the  previous 
step,  but  you  must  initialize  at  least  one  more  queue  named 
for  each  line  printer .  This  queue  will  serve  the  many  system 
tasks  that  conventionally  send  output  to  LP:  by  directing 
this  output  to  QMG.  This  is  known  as  a  device-specific 
queue.  PRINT  is  a  general  queue. 

A  device-specific  queue  must  be  initialized  before  the 
associated  device  is  initialized  (spooled).  For  LPO:,  the 
device-specific  queue  is  named  LPO. 

DCLMNITIAl  I7F/QUFUE  I. PO/PRINT 

MCRXJUE  I.POt/HRJP 


QUEUE 

MANAGER 


unspooled 


>  SUBMIT 


ZK-1 56-81 


Initialization  names,  creates,  and  starts  a  queue. 


You  will  need  this  extra  queue  even  if  your  system  has  only 
one  printing  device.  You  can  initialize  as  many  as  14 
additional  print  queues  for  a  total  of  16 .  One  must  be  the 
default  queue  PRINT.  The  remaining  15  can  be  device-specific 
or  general  queues.  There  must  be  a  device-specific  queue  for 
every  spooled  (initialized)  output  device.  Queues  for 
application  processors  are  print  queues. 
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4.  Next/  you  must  install  a  print  processor  for  each  physical 
printing  device  that  will  be  set  spooled  (by  means  of 
INITIALIZE) .  This  processor  "owns"  the  printer;  the 
processor  name  must  be  derived  from  the  printer  name.  For 
example/  LPO:  is  owned  by  LPO.  LPP.TSK  installs 

automatically  as  LPO.  The  print  processors  will  be  found 
with  the  privileged  utility  tasks. 

DCL>.  INSTALL  $1.  PP 


MCR>  INS  $LPP 


QUEUE 

MANAGER 


ZK-1 57-81 


If  you  have  additional  output  devices,  use  the  /TASK 
qualifier  to  install  their  print  processors  under  the  proper 
names.  You  can  initialize  as  many  as  15  print  processors. 
Applications  processors  are  considered  print  processors  for 
this  count. 


DCL>T NST Al  L  /TASK  H  PI  $1.  PP 
M C R  >T  NS  $  I ..  P  F*  /  TASK- L  P 1 
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5.  You  must  initialize  your  print  processors,  setting  whatever 
attributes  you  wish.  Any  initialization  of  a  print  processor 
sets  the  associated  output  device  spooled. 


DCL >1 N I T I AL. I ZF/PR I NTFR  L  PO/FL  AG~P  APF  ♦  2/FORii  ♦  0/1.  OWFRCASF 
MCR>GUE  I..P0  :  /SP/FL  :  2/FO  :  0/L0W 


>  SUBMIT 


The  command  assigns  the  queue  LPO  to  despooler  LPO.  The 
queue  must  exist  before  you  initialize  the  processor  LPO. 
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6.  Next,  you  must  install  the  interface  between  the  Queue 
Manager  and  other  system  tasks.  This  interface  is  handled  by 
$QMGPRT.TSK.  It  must  be  installed  as  PRT . . . .  It  will  be 
found  with  the  nonprivileged  utility  tasks. 

DCL  >  I NSTAL  l./TASK  *  PRT  ♦  .  .  *RMGPRT 


MCRMNS  *QMGPRT./TASK  =  PRT, 


>  SUBMIT 
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7. 


Next,  you  must  assign  queues  to  print  processors.  Assignment 
establishes  the  path  between  queue  and  print  processor.  The 
Queue  Manager  can  send  jobs  only  to  assigned  processors . 

DCL> ASSIGN /QUFIJF  PRINT  LPO 

M C R >  Q 1 1 E  LPO : /AS: PR  TNT 


>  SUBMIT 


When  you  complete  this  step,  two  queues  are  now 
the  same  processor  (because  queue  LPO  was 
processor  LPO  at  initialization) . 


assigned  to 
assigned  to 


You  can  assign  a  queue  to  more  than  one  processor  and  you  can 
assign  more  than  one  queue  to  a  processor. 


If  you  initialize  a  queue,  but  do  not  assign  it,  jobs  sent  to 
that  queue  will  not  be  processed  until  the  queue  is  assigned. 


This  completes  the  installation  process  for  the  RSX-11M  QMG. 
The  remaining  steps  apply  to  RSX-11M-PLUS  only. 
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8.  You  must  now  install  the  batch  processor, 
found  with  the  privileged  utility  tasks. 

DCt  >1  NS  TALL  *RP  R 

MCR> INS  $8  PR 


This  task  will  be 


BAPO 

QUEUE 

MANAGER 


LPO 


Queue 

LPO 

Queue  file 


LBO: 
[171QUEUE.SYS 


>  SUBMIT  '  >  PRINT1 

BPR.TSK  installs  automatically  as  BAPO. 

You  can  install  as  many  as  16  batch  processors, 
have  names  in  the  form  BAPn. 


They  must 
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9.  Next,  you  initialize  the  batch  processors 

DCL  >  JNJ/BATCH. . PROCESSOR  RAPO 
HCR>QUE  BAPO  * /BATCH 


BAPO 


>  SUBMIT  J 


QUEUE 

MANAGER 


LPO 


Queue 

BATCH 


Queue 

PRINT 

Queue 

LPO 


Queue  file 


LBO: 


[1,7]  QUEUE. SYS 


>  PRINT 
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10.  The  default  queue  BATCH  was  initialized  by 

START/QUEUE/MANAGER,  but  you  may  initialize  as  many  as  15 
additional  batch  queues  with  names  of  as  many  as  six 
alphanumeric  characters  in  any  form. 

DC!..  >  INI /a  POO 0 /PATCH 


mcr>  mu-:  poor) t /crib 


ZK-I63-81 


Note  that  batch  processors  do  not  need  device-specific  queues 
because  no  devices  are  associated  with  them. 
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11 •  Finally,  you  must  assign  batch  queues  to  batch  processors, 

DCL  >  ASSIGN/G  BATCH  BAPO 
HCR> Q U E  BAPO! /AS : BATCH 


PRINTS 

.PRINT 

FCS 

>  SUBMIT 


>  PRINT  " 


If  you  initialize  a  queue  but  do  not  assign  it  to  a 
processor,  jobs  can  be  queued,  but  they  will  not  be  processed 
until  the  queue  is  assigned. 
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7.2  QUEUE  MANAGER  COMMAND  DESCRIPTIONS 

The  operations  of  QMG  are  controlled  through  a  number  of  DCL  and  MCR 
commands.  The  functions  invoked  are  identical,  but  the  command  syntax 
is  different.  Use  whichever  command  syntax  you  are  accustomed  to.  In 
this  manual,  both  forms  of  the  syntax  appear  in  the  command 
descriptions;  the  DCL  commands  and  command  elements  are  to  the  left 
and  the  MCR  to  the  right.  In  the  section  titles,  MCR  commands  or 
command  elements  appear  in  parentheses.  In  the  examples,  commands  are 
identified  explicitly  by  the  DCL>  and  MCR>  prompts. 

The  processors,  devices,  and  device-specific  queues  all  have  names 
derived  from  the  name  of  the  spooled  device.  Thus,  if  LP1:  is  the 
spooled  device,  the  processor  that  "owns"  it  is  called  LP1  and  the 
device— specif ic  queue  is  also  called  LP1.  The  colon  (:)  portion  of 
the  device  name  can  be  omitted  from  references  in  DCL  commands  to 
processors,  devices,  and  queues.  The  colon  portion  must  be  included 
in  references  in  MCR  commands  to  processors,  devices,  and  queues.  You 
can  include  the  colon  portion  in  any  DCL  command,  but  it  is  required 
only  in  MCR  commands.  Furthermore,  in  MCR  commands,  all  queue  names 
must  be  terminated  by  a  colon,  whether  they  are  derived  from  device 
names  or  not.  Thus,  if  you  wish  to  refer  to  a  queue  named  XPRESS  in 
an  MCR  command,  you  must  refer  to  that  queue  as  XPRESS:. 

The  general  format  of  DCL  QMG  commands  is  as  follows: 

DCL>DCLcommand/QMGqualif ier[ s]  parameter [ s] [ / qualif ier[ s] ] 

The  general  format  of  MCR  QMG  commands  is  as  follows: 

MCR>QUE  ddnn:  /f unction[ :option[ s] ] [ /sw[ s] ] 

Command  descriptions  are  given  in  the  order  they  are  used  in  the 
narrative,  except  that  any  counteracting  commands  are  described  just 
after  the  setup  commands  they  counteract . 


7.2.1  INITIALIZE/  (QUE  /CR/SP) 

These  commands  create,  i^ame,  and  start  a  queue  or  processor. 

When  you  initialize  an  output  processor,  you  are  setting  its 
corresponding  device  spooled.  A  spooled  device  can  be  accessed  by  the 
Queue  Manager.  The  processor  or  task  must  be  installed. 


7. 2. 1.1  INITIALIZE/QUEUE  (QUE  /CR)  -  INITIALIZE/QUEUE  creates,  names, 
and  starts  a  queue. 

Formats 

DCL> INITIALIZE/QUEUE  queuename/qualif ier 

DCL  Parameter  Qualifiers 

/BATCH 

/PRINT 

MCR > QUE  ddnn : /CR : typ 

MCR  Queue  Types 

PRINT 

BATCH 
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Parameter 

queuename 

This  specifies  the  name  of  the  queue  to  be  initialized. 

Queue  names  BATCH  and  PRINT  are  reserved,  because  the  BATCH  and 
PRINT  queues  are  initialized  by  the  START /QUEUE /MANAGER  (QUE 
/ STA : QMG )  command. 

The  queue  named  BATCH  is  initialized  on  RSX-11M  systems,  but  is 
not  used,  and  is  not  accessible  or  displayed. 

You  must  initialize  a  queue  for  every  output  device  to  which  the 
Queue  Manager  is  to  send  print  jobs.  These  are  called 
device-specific  queues.  Otherwise,  any  six  alphanumeric 
characters  make  an  acceptable  queue  name  for  a  general  queue.  If 
you  have  no  processor  LP1,  LP1  is  then  a  general  queue  name. 

Device-specific  queues  must  be  initialized  before  the  associated 
processor . 

Parameter  Qualifiers 

This  qualifier  can  be  either  /BATCH  or  /PRINT.  The  qualifier 
tells  the  Queue  Manager  what  kind  of  queue  is  being  initialized. 
Queues  for  applications  processors  are  print  queues . 

The  default  qualifier  is  /PRINT.  For  the  sake  of  clarity,  you 
should  always  include  the  qualifier  when  initializing  a  queue. 

Examples 

D C L  >  ASSIGN/ G U F U F.  XPRFSS  l.POt 
MCR>  QI.JE  LPOt/AS  JXPRESS 

This  example  creates,  names,  and  starts  a  print  queue  named 
XPRESS .  The  queue  can  now  accept  print  jobs,  but  it  must  be 
assigned  to  an  output  processor  before  jobs  can  be  taken  from  the 
queue . 

DCL>  INITIAL I7F/QUFUF  XPRESS/PRINT 
HCR>  QUE  XPRESSt/CRt PRINT 

This  command  assigns  the  queue  initialized  in  the  previous 
example  to  a  print  processor. 


DCL  >  INITIAL  IZF/QUEUF  I.  PO/PRINT 
DCL>  T.  NT.  TI ALIZE/PRTNTER  l.POt 

MCR>  GUF  1.  POt/CR 
M C R >  QUE  LPOJ/SP 

This  example  creates,  names,  and  starts  a  print  queue  named  LPO . 
This  is  a  device-specific  queue  whose  name  is  derived  from  the 
name  of  an  output  device.  This  queue  must  be  initialized  before 
the  output  device  despooler  can  be  initialized.  After  both  the 
queue  and  output  device  despooler  are  initialized,  the  queue  can 
accept  print  jobs  and  the  named  printer  is  set  spooled. 
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Notes 

No  more  than  16  print  queues  (including  queues  for  applications 
processors)  can  be  initialized. 

On  RSX-11M-PLUS,  no  more  than  16  batch  queues  can  be  initialized. 
These  counts  include  the  default  PRINT  and  BATCH  queues. 


7. 2. 1.2  INITIALIZE/PROCESSOR  (QUE  /SP)  -  This  command  creates,  names, 
and  starts  an  output  despooler  or  batch  processor.  When  you 
initialize  an  output  despooler,  this  task  "owns"  a  hardware  device. 
This  is  setting  the  device  spooled;  a  spooled  device  can  be  accessed 
by  the  Queue  Manager . 

Formats 

DCL>  INITIALIZE/processortype  processorname/ [ / qualifier] 

MCR>QUE  processorname : /SP[ / sw[ s ] ] 

DCL  Processor  Types  MCR  Function 


/PROCESSOR  /SP 

/PRINTER  /SP 

/DEVICE  /SP 

/ BATCH_PROCESSOR  /BA 

/APPLICATIONS_PROCESSOR  /SP/EX 


DCL  Qualifiers 

/ FLAG_PAGE : n 
/LOWERCASE 
/UPPERCASE 
/FORMS :n 
/SHAREABLE 


MCR  Switches 

/FL:n 

/LOW 

/NOLO 

/FO:n 

/SHR 


Processor  Types 

/PROCESSOR  (/SP) 

/PRINTER  (/SP) 

/DEVICE  (/SP) 

The  DCL  processor  types  fall  into  three  groups.  One  group 
consists  of  /PROCESSOR,  /PRINTER,  and  /DEVICE.  These  three  are 
synonyms.  The  effect  of  each  is  the  same.  The  synonyms  are 
provided  to  assure  unambiguous  commands  and  documentation.  Use 
/PRINTER  for  line  printers  and  /DEVICE  for  other  output  devices. 

If  you  use  one  of  these  three  synonyms,  a  device-specific  queue 
must  exist  before  the  output  despooler  task  can  be  initialized. 
See  Notes. 

The  MCR  /SP  switch  performs  the  same  function.  There  are  no 
synonyms  in  the  MCR  form  of  this  command.  A  device-specific 
queue  must  exist  before  the  output  despooler  task  can  be 
initialized.  See  Notes. 

/BATCH_PROCESSOR  (/BA) 

This  is  the  second  DCL  processor  type.  Use  this  processor  type 
(or  option)  when  initializing  a  batch  processor. 


7-16 


SETTING  UP  AND  RUNNING  THE  QUEUE  MANAGER 


/ APPLICATIONS_PROCESSOR  (/SP/EX) 

This  is  the  third  DCL  processor  type.  Use  this  processor  type 
when  the  destination  of  the  output  is  not  a  physical  device,  but 
rather  some  software  application.  Use  /APPLICATIONS_PROCESSOR 
when  you  are  initializing  a  user-written  output  despooler  for 
which  the  physical  device  is  not  currently  in  the  system.  This 
makes  it  possible  for  the  Queue  Manager  to  despool  output  to  an 
applications  task,  to  a  network,  or  to  some  other  instance  of 
down-line  loading . 

In  MCR  format,  you  must  combine  the  /SP  and  /EX  options. 

When  you  use  this  command  in  either  form,  the  Queue  Manager  does 
not  check  for  the  existence  of  a  physical  device  before 
initializing  the  processor. 

Parameter 

processorname 

Remember,  the  names  of  the  device,  processor,  and  queue  are  the 
same,  and  interchangeable.  MCR  users  must  include  the  colon 
(  :  )  but  DCL  users  can  omit  it . 

You  must  initialize  device-specific  queues  before  you  initialize 
the  print  processor  with  the  same  number. 

If  initializing  a  batch  processor,  its  name  must  be  in  the  form 
BAPn. 

DCL  Qualifiers  and  MCR  Functions 

These  qualifiers  and  functions  have  meaning  for  initializing 
print  processors  only. 

With  the  exception  of  setting  the  number  of  flag  pages,  these 
qualifiers  have  no  effect  on  the  printed  output  of  the  printer 
being  initialized.  Rather,  these  qualifiers  define  the  kind  of 
print  jobs  the  processor  can  accept. 

Different  kinds  of  print  jobs  are  established  by  the  PRINT 
command  that  places  them  in  the  queue. 

/ FLAG_P AGE : n  ( / FL: n ) 

This  qualifier  specifies  how  many  flag  pages  are  to  precede  jobs 
and  files  printed  by  this  processor.  The  default  is  0  and  the 
value  of  n  must  be  0,  1,  or  2. 

If  the  processor  is  being  initialized  to  accept  special  forms, 
you  may  want  to  set  this  qualifier  to  0. 

If  you  wish,  you  can  change  the  value  set  here  with  the  /FLAG 
qualifier  to  the  START/  command  (/FL  switch  to  /STA  option). 

/LOWERCASE  (/LOW) 

If  you  initialize  a  printer  as  lowercase,  that  printer  will 
accept  print  jobs  with  lowercase  or  uppercase  specified  in  the 
PRINT  command.  Normally,  you  should  not  use  this  qualifier 
unless  the  hardware  involved  has  both  the  uppercase  and  lowercase 
character  sets . 
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/UPPERCASE  (/NOLO) 


If  you  initialize  a  printer  as  uppercase,  that  printer  will  not 
accept  print  jobs  with  lowercase  specified  in  the  PRINT  command. 
Normally,  you  should  not  use  this  qualifier  unless  the  hardware 
involved  does  not  have  the  lowercase  character  set.  This  is  the 
default . 


/FORMS :n  (/FOsn) 

The  value  for  n  can  range  from  0  through  255.  The  default  is  0. 

These  numbers  are  to  be  specified  by  your  users  in  their  PRINT 
commands . 


You  should  determine  which  forms  will  be  used  on  your  system  and 
assign  each  a  number.  You  should  then  edit  the  file 
LB: [1,24 jLPPBLD.CMD  to  set  up  the  forms  table  for  the  print 
processor  to  correspond  to  the  numbers  you  have  assigned  to  the 
forms.  Then,  you  must  build  the  processor. 

If  the  right  forms  are  not  in  an  available  printer,  their  jobs 
will  wait  until  the  printer  stops,  the  proper  forms  are  put  in 
place,  and  the  printer  is  restarted  with  a  new  value  for  /FORMS 
(/FO) . 


Forms  differ  by  their  length  and  width, 
in  the  forms  table. 


Both  values  can  be  set 


Setting  width  is  simply  a  matter  of  determining  how  many  columns 
are  needed  to  fill  in  the  form.  There  are  no  standard  widths  for 
forms,  but  80  and  132  are  the  most  common. 

Setting  length  requires  you  to  determine  whether  your  forms  are 
of  a  standard  length.  "Standard  length"  is  any  form  length  that 
can  be  set  on  your  printing  hardware.  If  the  hardware  can  handle 
the  form  by  setting  a  response  to  a  form-feed  character,  then  it 
is  a  standard  length  form,  and  the  form  feed  is  a  "real," 
(hardware)  form  feed. 

If  the  form  length  cannot  be  set  on  the  hardware,  then  it  is  a 
nonstandard  length.  In  this  case,  the  form  feed  must  be  replaced 
by  an  appropriate  number  of  line  feeds.  This  is  called  a 
"simulated,"  (software)  form  feed. 

The  following  table  shows  the  forms  requirements  for  a 
hypothetical  installation.  The  form  names  describe  different 
uses  for  these  special  forms,  but  the  names  have  no  significance 
otherwise . 


Form 


Assigned  n 


Width 


Length 


Standard? 


Accordion 

0 

132 

66 

Y 

Paychecks 

1 

40 

10 

Y 

Invoices 

2 

80 

66 

Y 

Stationery 

3 

80 

66 

Y 

Moon  Diary 

4 

22 

43 

N 

Stair  Log 

5 

112 

113 

N 

The  forms  table  can  be 
procedure  is  explained  in 

changed  at  LB : 
the  comments  in 

[  1 , 24 ]LPPBLD 
this  file. 

.  CMD 

This 


7-18 


SETTING  UP  AND  RUNNING  THE  QUEUE  MANAGER 


As  shipped ,  FORMS :0  is  66  lines  long  by  132  columns  with  real 
form  feeds.  FORMS :1  is  1  line  long  by  132  columns  with  simulated 
form  feeds;  FORMS : 2  is  2  lines  long  by  132  columns  with  simulated 
form  feeds;  and  so  on  through  FORMS :66  which  is  66  lines  long  by 
132  columns  with  simulated  form  feeds.  The  remaining  FORMS :n 
are  set  to  1  line  long  by  132  columns  with  simulated  form 
feeds.  Thus ,  if  you  specify  /FORMS: 43,  when  the  printer 
encounters  a  form  feed,  it  will  count  the  number  of  lines  on  the 
page  and  subtract  that  number  from  43.  The  printer  will  then 

reel  off  a  number  of  line  feeds  equal  to  the  difference.  You  may 
find  this  arrangement  satisfactory  if  your  installation  rarely 
uses  forms  other  than  standard  line-printer  paper,  but  if  you 
have  more  than  one  standard  form,  you  will  probably  want  to  make 
the  changes  in  the  forms  table  entries. 

/SHAREABLE  (/SHR) 

This  qualifier  establishes  the  processor  as  shareable.  This 
means  the  physical  device  is  not  "owned"  by  a  processor  if  it  is 
not  printing  a  job.  Normally,  the  output  processor  attaches  the 
device  when  it  is  initialized  and  no  other  job  can  access  the 
device  until  it  is  detached. 

If  you  initialize  the  processor  as  shareable,  the  device  is 
attached  at  the  beginning  of  the  QMG  print  job  and  detached  at 
the  end  of  the  job,  leaving  the  device  free  for  other  uses.- 

On  RSX-1 1M-PLUS ,  if  you  initialize  a  processor  as  shareable, 
transparent  spooling  to  that  device  will  not  work. 

Examples 

n  e  I.  >  I N I T I A I  1 7  F  /  P  R  0  C  F  S  S  0  R  L  p  o : 

MCR>QUF  LPO ♦ /SP 

LPO:  is  set  spooled.  Jobs  can  be  passed  to  it  from  the  Queue 

Manager . 

You  must  initialize  a  device-specific  queue  named  LPO  before  you 
can  initialize  the  processor  for  device  LPO:. 


DC!.::  INITIAL  IZF/PRINTFR  l  PI  ♦/FLAG ...  P  A  G  F  t  2 
MCR>-QUE  I..P1.  :  /SP/FL:  2 

This  command  initializes  a  print  processor  to  control  LP1 :  and 
specifies  that  jobs  run  on  this  printer  will  be  preceded  by  two 
flag  pages.  Jobs  specifying  flag  pages  in  the  PRINT  command  will 
have  two  flag  pages  at  the  head  of  the  job. 


D C L  >  I N 1  T I A L 1 7 F  / P R I N T F R  1.  P  1  /NO!  0  WFR 
M C R > Q U E  I . P 1.  i/S P / N 0 L 0 U 

This  command  initializes  a  print  processor  to  control  LP1 :  and 

states  that  the  printer  will  only  accept  jobs  specifying 
uppercase  in  the  PRINT  command. 
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DCL> INI /BATCH-PROCESSOR  BAPO 
MCR>QUE  BAPO : /BA 

This  command  creates,  names,  and  starts  batch  processor  BAPO,  on 
an  RSX-1 1M-PLUS  system. 

DCl  >  INI /PRO  L .PO/FL.AG:  2/FORMS  J  0/1  OWER 

MCR>QUE  LPO t /SP/FL t 2/FO  J  O/LOW 

This  command  creates,  names,  and  starts  print  processor  LPO.  The 
printer  has  the  lower-case  character  set.  Jobs  will  have  two 
flag  pages  when  printed. 

Notes 

No  more  than  16  batch  processors  on  an  RSX-1 1M-PLUS  system,  or  16 
print  processors  (including  applications  processors)  can  be 
initialized . 

If  you  are  initializing  an  output  despooler  that  attaches  a 
physical  device,  the  system  checks  for  the  existence  of  the 
device  and  of  its  device-specific  queue  before  the  command  is 
executed.  Therefore,  the  following  procedure  must  be  followed. 

1.  The  device  must  be  part  of  the  current  system. 

2.  You  must  initialize  a  device-specific  queue  for  the  device 
before  you  initialize  an  output  despooler  of  the  same  type 
and  number. 

When  you  initialize  an  output  processor,  it  is  named  and 
started  and  has  its  device-specific  queue  assigned  to  it. 

3.  For  each  print  processor,  there  must  be  a  print  queue,  called 

the  device-specific  queue,  with  a  corresponding  name.  The 
printer  named  LPO:  is  owned  by  the  output  despooler  named 
LPO.  There  must  also  be  a  device-specific  queue  named  LPO. 
The  processor  cannot  be  named  until  the  device-specific  queue 
has  been  initialized.  This  queue  will  be  assigned 

automatically  to  the  processor  whose  name  it  shares,  but  the 
device— specif ic  queue  can  be  deassigned  and  assigned 

elsewhere  after  initialization. 

This  procedure  does  not  apply  to  initializing  batch 
processors  or  applications  processors.  Neither  a  physical 
device  nor  a  device-specific  queue  is  needed  to  initialize  a 
batch  processor  or  applications  processor. 

There  can  also  be  print  queues  whose  names  do  not  correspond 
to  output  devices.  These  are  called  general  queues. 

The  lowercase/uppercase  attributes  have  no  effect  on  the  nature 
of  the  printer's  output.  They  do  not  cause  jobs  to  be  printed 
all  uppercase.  These  qualifiers  set  up  a  "mask"  that  must  be 
matched  by  the  attributes  of  print  jobs  before  they  can  be  sent 
to  the  printer.  A  printer  without  the  lowercase  character  set 
can  be  initialized  lowercase  and  it  will  accept  print  jobs  with 
lowercase  specified  in  the  PRINT  command.  This  might  be  done  if 
a  printer  with  the  lowercase  character  set  was  temporarily 
unavailable.  As  a  general  rule,  however,  you  should  only 
initialize  printers  with  the  characteristics  they  actually  have 
to  avoid  confusion. 
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(The  line  printer  driver  does,  however,  affect  the  printer's 
output,  through  lowercase-to-uppercase  translation.  See  the 
discussion  of  SET  /LOWER  in  the  RSX-11M/M-PLUS  MCR  Operations 
Manual,  or  the  discussion  of  SET  DEVICE  /LOWER  in  the  RSX-11M 
Command  Language  Manual  or  the  RSX-11M-PLUS  Command  Lanquaqe 
Manual . )  -  - 


7.2.2  DELETE/  (QUE  /DEL) 

You  can  delete  queues  or  processors. 


7. 2. 2.1  DELETE/QUEUE  (QUE  /DELsQ)  -  DELETE/QUEUE  deletes  queues  by 
name. 

Formats 

DCL> DELETE/QUEUE  queuename/ ERASE 
MCR>QUE  queuename : /DEL: Q 
Parameter 

queuename/ERASE  (/DEL:Q) 

This  specifies  the  name  of  a  queue  to  be  deleted.  Only  a 
privileged  user  can  delete  a  queue  using  this  parameter.  The 
default  queues  BATCH  and  PRINT  cannot  be  deleted. 

If  the  queue  has  jobs  in  it,  it  will  be  marked  for  delete.  When 
the  last  job  leaves  the  queue,  the  queue  itself  is  deleted.  No 
new  jobs  can  be  entered. 

You  cannot  delete  device-specific  queues  until  after  you  have 
deleted  the  processor  with  the  same  number.  See  next  section. 

Examples 


001.  > DEI  FTF/QUFUF  MONA/FRASE 
MCR > Q U E  MONA l /DEL  *  Q 

This  privileged  command  deletes  the  queue  named  MONA  if  it  is 
empty.  If  the  queue  has  entries,  it  is  marked  for  delete,  and 
will  be  deleted  as  soon  as  the  last  job  is  removed  from  the 
queue.  Note  the  colon  in  the  queue  name  in  the  MCR  example. 


7. 2. 2. 2  DELETE/PROCESSOR  (QUE  /UNSP)  -  DELETE/PROCESSOR  deletes  print 
processors,  output  despoolers,  or  batch  processors  by  name.  The 
command  also  sets  the  device  unspooled. 

Formats 

DCL>DELETE/ processortype  processorname 

MCR>QUE  processorname : /UNSP 
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DCL  Processor  Types 


MCR  Functions 


/PROCESSOR 

/PRINTER 

/DEVICE 

/BATCHPROCESSOR 
/ APPLICATIONS_PROCESSOR 


/UNSP 

/UNSP 

/UNSP 

/UNBA 

/UNSP 


Parameter 

processorname 

For  physical  devices  *  the  name  of  the  processor  is  identical  with 
the  name  of  the  physical  device.  Thus,  the  device  LP1:  is 
controlled  by  processor  LP1 : •  DCL  commands  do  not  require  that 
you  include  the  colon  ( : ) ,  but  you  must  include  the  colon  in  all 
MCR  commands . 

Batch  processors  have  names  in  the  form  BAPnnn,  where  nnn  is  one 
to  three  Radix-50  characters. 

Applications  processors  have  names  of  six  Radix— 50  characters . 

Processor  Types 

/PROCESSOR  (/UNSP) 

/PRINTER 

/DEVICE 

The  DCL  processor  types  fall  into  three  groups.  One  group 
consists  of  /PROCESSOR,  /PRINTER,  and  /DEVICE.  These  three  are 
synonyms.  The  effect  of  each  is  the  same.  The  synonyms  are 
provided  to  assure  unambiguous  commands  and  documentation.  Use 
/PRINTER  for  line  printers  and  /DEVICE  for  other  output  devices. 

If  you  use  one  of  these  three  synonyms,  the  device-specific  queue 
cannot  be  deleted  until  after  the  output  despooler  task  is 
deleted. 

These  distinctions  do  not  apply  in  MCR. 

/ BATCH_PROCESSOR  ( /UNBA) 

This  is  the  second  DCL  processor  type.  Use  this  processor  type 
when  deleting  a  batch  processor. 

/APPLICATIONSPROCESSOR  (/UNSP) 

This  is  the  third  DCL  processor  type.  Use  this  processor  type 
when  the  destination  of  the  output  is  not  a  physical  device,  but 
rather  some  software  application.  Use  /APPLICATIONS_PROCESSOR 
when  you  are  deleting  a  user-written  output  despooler. 


Examples 


D C L >  D F L  F  T F / P  R  0  C F  S  S  0  R  IPO 
MCR>  a UE  l.PO ‘> /UNSP 

This  example  deletes  processor  LPO,  the  owner  of  line  printer 


LPO: . 


DCL>  DELETE/BATCH_PROCESSOR  BAP 2 
MCR>  QUE  BAP  2  :  /UNBA 
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The  commands  are  equivalent?  they  delete  the  batch  processor 
named  BAP2,  on  an  RSX— 11M— PLUS  system.  Note  the  colon  in  the  MCR 
command . 

DCL > DEL  FT F /PROCESSOR  L  PO 
DCL>  DEI.ETE/QUEUE  LPO/ERASE 

M C R > QUF  LPOJ/UNSP 
MCR> QUF  LPO  * /DEL ♦ Q 

This  example  shows  the  order  you  must  follow  to  delete  a 
device-specific  queue. 


Notes 


DELETE/PROCESSOR  (/UNSP)  counteracts  INITIALIZE/PROCESSOR  (/SP). 

For  maximum  clarity,  operators  using  DCL  should  use  the  specific 
qualifiers  /PRINTER  and  /DEVICE  rather  than  the  synonym 
/PROCESSOR  when  deleting  output  despoolers. 


7.2.3  ASSIGN/QUEUE  (QUE  /AS:) 

ASSIGN/QUEUE  (QUE  /AS:)  establishes  a  path  from  a  queue  to  a 
processor . 

Formats 

DCL> ASSIGN/QUEUE  queuename  processorname 
MCR>QUE  processorname : /AS : queuename 
Parameter 
queuename 

This  specifies  the  queue  that  is  to  be  assigned  to  the  processor, 
processorname 

This  specifies  the  processor  to  which  the  queue  is  to  be 
assigned . 

When  assigning  queues  to  output  devices,  use  the  the  device  name 
in  the  form  ddnn:. 

Notes 

This  command  can  be  used  to  redirect  output  from  one  processor  to 
another. 

Other  uses  include  grouping  related  processors,  such  as  plotters, 
under  a  single  queue. 


7.2.4  DEASSIGN/QUEUE  (QUE  /DEA) 

DEASSIGN/QUEUE  (QUE  /DEA)  counteracts  ASSIGN/QUEUE  (/AS).  It  is  used 
to  eliminate  the  path  from  a  queue  to  a  processor. 
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Formats 

DCL> DEASSIGN/QUEUE  queuename  processorname 
MCR>QUE  processorname : /DEA: queuename 
Parameters 
queuename 

This  specifies  the  queue  that  is  to  be  deassiqned  from  the 
processor. 

processorname 

This  specifies  the  processor  from  which  the  queue  is  to  be 
deassigned. 

When  deassigning  queues  from  output  devices,  use  the  device  name 
in  the  form  ddnn:. 

7.2.5  STOP/  (QUE  /STO) 

STOP/  (/STO)  is  used  to  stop  queues,  the  Queue  Manager,  or  a 
processor . 


7. 2. 5.1  STOP/QUEUE  (QUE  /STOsQUE)  -  STOP/QUEUE  stops  queues. 

Formats 

DCL> STOP/QUEUE  queuename 
MCR>QUE  queuename: /STO: QUE 
Parameter 
queuename 

This  specifies  the  queue  to  be  stopped.  Following  the  command, 
no  jobs  will  be  taken  from  the  queue,  but  jobs  can  still  be  added 
to  the  queue . 

If  a  job  is  active  at  the  time  this  command  is  issued,  the  job 
will  be  allowed  to  complete  processing  but  no  further  jobs  will 
be  dequeued . 

Note  the  colon  (:)  in  the  MCR  form  of  the  command. 


7. 2. 5. 2  STOP/QUEUE/MANAGER  (/STOsQMG)  STOP /QUEUE/MANAGER  (/STO:QMG) 
stops  the  Queue  Manager  and  deletes  all  processors,  whether  batch 
processors  or  output  despoolers. 

Formats 

DCL>  stop/queue/managerC /ABORT ] 

MCR>QUE  / STO : QMG [ : AB ] 
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Notes 


If  you  issue  this  command  without  the  /ABORT  ( :AB)  qualifier,  QMG 
is  marked  for  stop.  As  soon  as  all  currently  active  jobs  on  all 
processors  are  done,  QMG  will  stop.  No  more  jobs  can  be  entered 
in  the  queue.  See  also  example  in  Section  7. 2. 6. 2. 

If  you  include  the  /ABORT  (:AB)  qualifier,  all  active  jobs  are 
held  immediately  and  QMG  exits  without  further  delay. 


7. 2. 5. 3  STOP/PROCESSOR  (QUE  /STO)  -  STOP/PROCESSOR  (/STO)  stops  a 
processor . 

Formats 


DCL> STOP /processor type  processorname[ /qualifier ] 

MCR>QUE  processorname :/STO[ :opt] 


DCL  Processor  Types 


MCR  Functions 


/PROCESSOR  /STO 
/PRINTER  /STO 
/DEVICE  /STO 
/ APPLICATIONS_PROCESSOR  /STO 
/BATCH_PROCESSOR  /STO, 

DCL  Parameter  Qualifiers  MCR  Options 


/PAUSE 

/J0B_END 

/FILE_END 

/ABORT 


<no  equivalent 
:  EOJ 
:  EOF 
:  AB 


Parameter 

processorname 

When  stopping  print  processors,  use  the  device  name  in  the  form 
ddnn : . 

This  command  has  no  effect  on  the  status  of  jobs  in  queues,  but 
no  jobs  will  be  dequeued  while  the  processor  is  stopped. 

Processor  Types 

/PROCESSOR  (/STO) 

/PRINTER 

/DEVICE 

The  DCL  processor  types  are  synonyms.  The  effect  of  each  is  the 
same.  These  synonyms  are  provided  to  assure  unambiguous  commands 
and  documentation.  Use  /PRINTER  for  line  printers,  /DEVICE  for 
other  output  devices  and  /BATCH_PROCESSOR  for  batch  processors. 
MCR  users  use  / STO  across  the  board. 

/BATCH_PROCESSOR  (/STO) 

Use  this  processor  type  when  stopping  a  batch  processor. 
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/ APPLICATIONS_PROCESSOR  (/STO) 

Use  this  processor  type  when  the  destination  of  the  output  is  not 
a  physical  device,  but  rather  some  software  application.  Use 
/APPLICATIONS_PROCESSOR  when  you  are  stopping  a  user-written 
output  despooler. 

Qualifiers 

Only  one  qualifier  is  permitted.  The  choice  of  qualifier  here 
affects  the  restarting  of  jobs  when  the  processor  is  started 
again . 

/PAUSE  <no  equivalent 

This  is  the  default;  it  causes  the  processor  to  stop  at  the  end 
of  the  current  line.  There  is  no  MCR  qualifier;  /STO  is 
sufficient . 

/J0B_END  ( : EO J ) 

This  qualifier  causes  the  processor  to  stop  at  end  of  the  current 
job. 

/FILE__END  (  :EOF ) 

This  qualifier  causes  the  processor  to  stop  at  end  of  the  current 
file . 

/ABORT  (:AB) 

This  qualifier  causes  the  processor  to  stop  immediately.  The 
current  job  is  held  in  its  queue. 

Notes 

This  command  is  counteracted  by  START/PROCESSOR  (/STA).  You 
cannot  issue  START/PROCESSOR  (/STA)  until  the  processor  actually 
stops . 


7. 2. 5. 4  STOP/ABORT  (QUE  /KIL)  -  STOP/ABORT  (/KIL)  deletes  the  active 
job  on  a  given  processor.  Privileged  users  can  delete  any  job; 
nonprivileged  users  can  delete  their  own  jobs .  You  do  not  need  to 
know  the  queue  name  or  job  name  to  delete  the  job,  only  the  name  of 
the  processor. 

Formats 

DCL> STOP /ABORT  processorname 
MCR > QUE  processorname: /KIL 
processorname 

This  specifies  the  processor  whose  active  job  you  wish  to  delete. 
Note  that  the  MCR  command  format  requires  a  colon  ( : )  after  the 
processor  name. 

You  can  stop  jobs  running  on  any  processor  under  the  control  of 
QMG,  including  RSX-11M-PLUS  batch  processors. 
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Examples 


DCL> STOP/ABORT 
p  t  o  r;  e  s  %  o  r  ?  I ..  P  0 


This  example  shows  how  to  stop  a  print  job  on  LPO:  The  currently 
active  job  is  deleted  from  the  queue  and  the  next  eligible  job  is 
queued . 


Notes 

Use  this  command  to  quickly  stop  a  processor,  such  as  a  line 
printer  printing  nothing  but  form  feeds . 

As  soon  as  the  active  job  is  deleted,  QMG  passes  the  next 
eligible  job  to  the  processor.  The  processor  has  not  been 
aborted  or  killed,  only  the  active  job  on  that  processor. 

You  can  also  delete  the  active  job  on  a  card-reader  processor 
with  this  command. 


7.2.6 


START/  (que  /sta) 


START/  (QUE  /STA)  is  used  to  start  a  queue,  the  Queue  Manager,  or  a 
processor.  START/  (QUE  /STA)  counteracts  STOP/  (/STO). 


7. 2. 6.1  START/QUEUE  (QUE  /STA) 
queue . 

Formats 

DCL> START/QUEUE  queuename 
MCR>QUE  queuename : /STA 
Parameter 
queuename 


This  specifies  the  queue  to  be  started, 
queue  that  has  been  stopped.  Note 
format . 


-  START/QUEUE  (QUE  /STA)  starts  a 


This  command  starts  a 
the  colon  ( : )  in  the  MCR 


7. 2. 6. 2  START/QUEUE/MANAGER  (QUE  / STA : QMG )  -  START /QUEUE /MANAGER  (QUE 
/ STA : QMG )  starts  the  Queue  Manager,  initializes  the  default  queues 
PRINT  and  BATCH,  and  creates  the  queue  file  LBO : [ 1 , 7 ]QUEUE . SYS  if  it 
does  not  exist.  The  command  also  clears  all  queue  assignments.  If 
the  queue  file  was  intact,  all  queues  will  still  contain  their  jobs, 
but  will  not  be  assigned  to  processors. 

Formats 

DCL>START/QUEUE/MANAGER 
MCR>QUE  /STA: QMG 
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Examples 

D C L  > START/ QUEUE /MANAGER 
MCFO  GUF  /STAJQMG 

Starts  Queue  Manager.  Initializes  the  default  queues  PRINT  and 
BATCH,  if  they  are  not  already  initialized.  Clears  all 

assignments  of  queues  to  processors. 

Any  jobs  that  were  active  at  the  time  the  Queue  Manager  was 

stopped  will  be  held  when  the  Queue  Manager  is  started  again. 

All  other  jobs  retain  the  status  they  had  when  QMG  was  stopped. 

All  processors  must  be  reinitialized. 

The  default  queue  BATCH  is  initialized  on  RSX-11M  systems  as  well 
as  RSX-1 1M-PLUS ,  but  it  is  neither  accessible  nor  displayed. 

DC  I  .>  STOP /QUEUE/MANAGER 

mcr>  que  /stojqmg 

With  this  command,  the  Queue  Manager  is  stopped,  and  all 

processors  are  deleted. 


D Cl. >  S T A R T / G1JEIJE/MANA G E R 
H C R >  QUE  /ST  A  JGMG 

This  command  clears  all  assignments  of  queues  to  processors. 


D C L >  X N I T I A L IZE /PRINTER  L P 0 

HC|  >  INITIAL  I ZF /PR INTER  L PI 

PCI  :•  INITIALIZE/BATCH -PROCESSOR  BAPO 

0 c L >  I N I T I A L. 1 7F/BAT C H .  P R OCF.SSO R  B A P 1 

DCL>  ASSIGN/ QUEUE  PRINT  LPO 

Or: |  >  ASSIGN/ GUF LIE  PRINT  L.P1 

DCL>  ASSIGN/QUEUE  BATCH  BAPO 

D  C  L.  >  A  S  S 1 1«  N  /  Q  U  E  U  F  B  A  T  C  H  B  A  P 1 


MCR>  ODE 
hCR>  QUE 
NCR;  QUE 
HCR>  QUE 
MCR>  Q U E 
HCR>  QUF 
NCR>  QUE 
HCR>  QUF 


LPO J/SP 
L.P1  :/sp 
BAPO : /BA 
BAP  I :  /BA 
LPO ♦ /AS ♦ PRINT 
I.  pi:  /as:  PRINT 
bapo:/as jbatch 
BAP.1.  x  /as:  batch 


These  commands  recreate  the  network  of  queues  and  processors, 
that  RSX-1 1M  systems  have  no  batch  processors. 

DCL>  RELEASE /JOB  PRINT  BOBO 


MCR>  GUF  PRINT tBOBO/REL 


Note 


This  command  releases  a  held  job  that  was  active  at  the  time  the 
system  crashed. 
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7. 2. 6. 3  START/PROCESSOR  (QUE  /STA)  -  START/PROCESSOR  (QUE  /STA) 
starts  a  batch  processor  or  output  despooler. 

Formats 


DCL>START/processortype  processorname  [/qualifier[s]] 

MCR>QUE  processorname :/STA[ :opt[s]] 


DCL  Processor  Types 


DCL  Qualifiers 


/PROCESSOR 

/PRINTER 

/DEVICE 

/BATCHJPROCESSOR 
/APPLICATIONS  PROCESSOR 


/FORMS :n 
/ FLAG : n 
/CONTINUE 
/RESTART 
/NEXT_JOB 
/ TOP_OF_FILE 
/BACKSPACE :n 
/FORWARDSPACE : n 
/ AT_P AGE : n 
/ALIGN 


MCR  Options 

/FO :  n 
/FL:n 

<no  equivalent > 

:NE 

:  RES 

:  PA :  0 

:  BA :  n 

:FW:n 

:PA:n 

/AL 


Parameter 

processorname 

ddnn: 

This  specifies  the  processor  to  be  started.  When  starting  a 
stopped  output  processor,  use  the  device  name  in  the  form  ddnn:. 


Processor  Types 

/PROCESSOR 

/PRINTER 

/DEVICE 

/ BATCH_PROCESSOR 
/ APPLICATIONS_PROCESSOR 

These  are  DCL  synonyms.  The  effect  of  each  is  the  same.  These 
synonyms  are  provided  to  assure  unambiguous  commands  and 
documentation.  Use  /PRINTER  for  line  printers,  /DEVICE  for  other 
output  devices,  /BATCH_PROCESSOR  for  batch  processors,  and 
/ APPLICATIONS_PROCESSOR  for  applications  processors.  In  MCR 
format,  use  the  /STA  option. 

Qualifiers 

Some  qualifiers  have  meaning  for  starting  either  batch  or  print 
processors,  and  some  have  meaning  for  print  processors  only.  See 
descriptive  text. 
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This  field  is  restricted.  You  can  include  either  /FORMS:  (/FO: ) 
or  /FLAG:  (/FL:)  or  both,  or  you  can  include  any  one  of  the 
remaining  qualifiers,  if  permitted. 

/FORMS:  (/FO:)  and  /FLAG:  (/FL:)  have  meaning  for  print 

processors  only. 

/FORMS :n  (/FO:n) 

This  overrides  the  forms  value  set  when  the  processor  was 

initialized.  The  value  n  can  be  any  number  from  0  through  256. 

/ FLAG : n  (/FL:n) 

This  overrides  the  flag  value  set  when  the  processor  was 

initialized. 

When  the  processor  starts  again,  the  Queue  Manager  sends  the  next 
job  that  matches  the  attributes  of  the  processor. 

/CONTINUE 

This  specifies  that  the  processor  carry  on  from  wherever  it  was 
stopped.  This  is  the  default.  MCR  format  requires  no  switch. 

/RESTART  ( :RES ) 

This  specifies  that  interrupted  jobs  be  restarted  from  the 

beginning  of  the  file  that  was  being  processed  when  the  processor 
was  stopped.  This  qualifier  affects  only  jobs  that  were  ACTIVE 
at  the  time  the  processor  stopped. 

This  qualifier  may  conflict  with  the  desires  of  your  users  who 
have  specified  /NORESTART  in  their  PRINT  or  SUBMIT  commands . 
This  qualifier  causes  such  jobs  to  be  restarted  at  the  start  of 
the  file  being  processed  when  the  processor  was  stopped.  You 
should  check  the  queue  display  for  such  jobs  before  using  this 
qualifier.  The  /CONTINUE  (default)  qualifier  will  not  affect 
such  jobs . 

The  action  of  this  qualifier  further  depends  on  the  qualifier  to 
the  STOP/  (/STO)  command  that  stopped  the  processor  in  the  first 
place . 

If  the  qualifier  was  /PAUSE  (the  default  for  /STO),  then  any  jobs 
active  at  that  time  will  be  restarted  at  their  beginning. 

If  the  qualifier  was  /FILE_END  (:EOF),  then  any  jobs  active  at 
that  time  will  be  restarted  at  their  beginning,  unless  the  active 
file  was  the  last  one  in  the  job. 

If  the  qualifier  was  /ABORT  ( :AB )  (or  if  the  system  crashed),  the 
current  active  job  was  held  in  its  queue,  so  the  restart 
qualifier  will  have  no  effect. 

Likewise,  if  the  qualifier  was  /JOB_END,  (:EOJ)  there  will  have 
been  no  current  job,  so  the  restart  qualifier  will  have  no 
effect . 

/NEXT_JOB  ( :NE) 

This  specifies  that  the  processor  start  at  the  beginning  of  the 
next  job. 
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/TOP_OF_FILE  ( : PA : 0 ) 

This  specifies  that  the  processor  start  at  the  top  of  the  current 
file  in  the  current  job. 

The  qualifiers  /CONTINUE  (the  default  for  / STA ) ,  /RESTART  (/RES), 
/NEXT__JOB  (/NE),  and  /TOP_OF__FILE  (PA:0)  are  appropriate  for  both 
print  and  batch  processors . 

/BACKSPACE :n  ( : BA : n ) 

This  specifies  that  the  processor  start  n  pages  back  in  the 
current  job. 

/FORWARDSPACEin  (:FW:n) 

This  specifies  that  the  processor  start  n  pages  forward  in  the 
current  job. 

/ PAGE : n  (:PA:n) 

This  specifies  that  the  processor  start  at  specified  page  in  the 
job  that  was  active  when  the  processor  was  stopped. 

These  page-related  qualifiers  have  meaning  for  print  processors 
only.  They  will  have  no  effect  unless  the  user  specified  a  page 
length  qualifier  in  the  PRINT  command. 

/ALIGN  (:AL) 

This  informs  the  print  processor  that  the  paper  in  the  line 
printer  is  currently  at  the  top  of  a  form.  It  is  used  when  you 
have  stopped  the  print  processor  to  change  forms.  The  print 
processor  maintains  a  count  of  how  many  lines  it  has  gone  down  on 
a  form.  The  /ALIGN  (/AL)  qualifier  clears  that  count  for  new 
forms . 

Examples 

HCL>  ST  ART /PR  INTER  I..P0 
MCR> QUF  I  PC? /STA 

This  example  starts  print  processor  LPO:.  Printing  continues 
from  the  point  at  which  it  was  stopped. 

BCL> START/PRINTER  LPO/FLAGt 2 

NCR> QUF  l POt/STA/FL J2 

This  example  starts  print  processor  LPO:.  The  processor  will  put 
two  flag  pages  at  the  head  of  the  job  and  at  the  head  of  each 
file  if  the  user  specifies  flag  pages  in  a  PRINT  command. 

D  C I .  >  S I A  R  T  /  BAT  C  H  ...  PROCESSOR  BAPO 

H C R > QUF  BAPO : /STA 

This  example  starts  batch  processor  BAPO.  Batch  processing 
continues  from  the  point  at  which  it  was  stopped. 
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DCL>  START/BATCH  B APO/CONTTNUE 
H C R >  QUF  BAPOt/STA 
The  two  examples  are  equivalent. 

BCL>*  START/PR  INTER  LP1/REST ART 
MCR>  QUF  I.  PI  J /ST  a:  RES 

This  example  starts  print  processor  LP1 : .  The  job  active  at  the 
time  the  processor  was  stopped  is  restarted. 

Notes 

You  should  choose  with  care  between  the  /RESTART  (:RES)  and 
/CONTINUE  (MCR  default)  operations.  A  restart  may  conflict  with 
the  desires  of  users  with  print  or  batch  jobs  active  at  the  time 
a  processor  is  stopped. 

Users  can  specify  /NORESTART  (/-RES)  in  their  PRINT  or  SUBMIT 
commands.  If  a  print  or  batch  job  with  this  attribute  is  active 
when  the  processor  is  stopped,  and  you  start  the  processor  with 
the  /RESTART  (:RES)  qualifier,  you  will  be  restarting  the  jobs  at 
the  top  of  the  file  that  was  being  processed  when  the  processor 
was  stopped,  which  the  user  did  not  want  to  happen.  The 
/CONTINUE  (MCR  default)  qualifier  will  continue  such  jobs  as  the 
user  expected. 

If  you  are  restarting  a  processor  to  handle  special  forms,  you 
will  probably  want  to  set  the  /FLAGS  ( : FL)  attribute  to  0  to 
avoid  having  a  banner  page  printed  on  your  special  forms . 
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THE  SHUTUP  PROGRAM 


SHUTUP  is  the  system  program  that  enables  orderly  shutdown  of  an 
RSX-11M  or  RSX-11M-PLUS  system.  SHUTUP  sends  warning  messages,  aborts 
nonprivileged  tasks,  and  dismounts  devices  on  the  system. 


8.1  PREREQUISITES  TO  RUNNING  SHUTUP 

To  shut  down  a  system  using  SHUTUP,  the  following  tasks  must  be 
installed: 

•  INDIRECT,  the  MCR  Indirect  Command  Processor 

•  ACS,  if  dynamic  checkpoint  space  is  established 

•  BYE,  if  multiuser  protection  support  is  included 

•  DMO,  if  there  are  any  mounted  devices 

•  ELI,  if  error  logging  is  active 

•  ACC,  in  an  RSX-11M-PLUS  system  that  includes  Resource 
Accounting 

If  LB: [1, 2]SHUTUP.CMD  is  present,  you  may  want  it  to  install  ACS,  BYE, 
DMO,  ELI,  and  ACC.  See  Section  8.5. 


8 . 2  INVOKING  SHUTUP 

Invoke  SHUTUP  from  a  privileged  terminal  as  follows: 

>  RUN  $  SHUTUP  (REJ) 

On  RSX-11M  systems,  SHUTUP  displays  the  following  message  when 
invoked: 

R S X - 1. 1  M  SHUT  DOWN  PROGRAM 

On  RSX-11M-PLUS  systems,  SHUTUP  displays  the  following  message  when 
invoked: 

RSX-1.  t M-PUJS  SHUT  DOWN  PROGRAM 
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8 . 3  SHUTUP  INPUT 

SHUTUP  prompts  for  the  number  of  minutes  as  follows: 

1.  Number  of  minutes  to  wait  before  the  system  is  shut  down 

2.  Number  of  minutes  between  warning  messages 

3.  Number  of  minutes  before  disabling  logins 

If  you  specify  less  than  4  minutes  to  wait  before  shutdown,  SHUTUP 
does  not  ask  the  last  2  questions.  Instead,  SHUTUP  sets  the  interval 
between  messages  to  1  minute  and  disables  logins  immediately. 

The  number  of  minutes  between  messages  must  be  greater  than  zero  and 
less  than  the  number  of  minutes  before  shutdown  minus  three.  If  you 
specify  either  value  incorrectly,  SHUTUP  rejects  your  answer  and 
reprompts . 

The  following  is  an  example  of  SHUTUP  prompts  and  user  input  on  an 
RSX-11M  system: 

E n  ter  in i n u t e s  to  wait  b e f  o re  s h u t  o o wn  t  15  (BIT) 

E  n  t  e  r  in  i  n  u  t  e  s  b  e  t  w  e  e  n  in  e  s  s  a  3  e  <  >  t  3  (RET) 

Enter  minutes  to  wait  before  disabling  logins*  5  (pet) 

If  you  are  using  an  RSX-11M-PLUS  or  Micro/RSX  system,  SHUTUP  asks  an 
additional  question,  which  is  shown  in  the  following  example: 

Enter  minutes  to  wait  before  shut  down*  1.5  © 

E  n  t  e  r  m  i.  n  u  t  e  s  b  etwee  r  i  m  e  s  s  a  3  e  s  $  3  © 

E  n  t  e  r  in  i  r»  u  t  e  s  t  o  w  a  i  t  b  e  f  o  r  e  d  i  s  a  b  1  i  n  S  1  n  S  i.  n  s  ♦  5  © 

R e a s o n  f o r  s h u t d o w n  < < C R >  f o r  none) t  F I F L  R  S F R V I C F  P h  © 

After  receiving  your  input,  SHUTUP  asks  for  confirmation  as  follows: 

OK  to  shutdown?  EY/Nlt 

SHUTUP  terminates  without  taking  any  action  if  your  response  to  the 
question  is  N.  If  your  response  is  Y,  SHUTUP  sends  warning  messages 
to  terminals.  Section  8.4  explains  the  messages. 


8.4  SHUTUP  OUTPUT 

SHUTUP  sends  warning  messages  to  terminals.  If  the  system  does  not 
support  multiuser  protection,  SHUTUP  sends  warning  messages  to  all 
terminals.  If  the  system  does  support  multiuser  protection,  SHUTUP 
sends  warning  messages  only  to  logged-in  terminals.  On  multiuser 
systems,  a  terminal  set  to  NOBROADCAST  receives  the  warning  messages 
only  during  the  last  five  minutes  before  shutdown. 

SHUTUP  sends  the  following  warning  messages: 

P 1  e a s e  f  i. n  i. s h  u p  7  15  m  i n u  t e s  b e f  o r e  s h u t d o w n  - ~  W A l.  N U T  R Paso n  f  o  r 
s h u i d o w n :  F  :i.  e  T  d  Serv  i  * :•  e  P M 

Three  minutes  later,  SHUTUP  sends  another  message: 

p 1 e a s e  f i n i s h  u p  ?  12  m i n u tes  b e f  o r e  s h u t d o w n  - -  WALNUT 
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The  messages  include  a  6-character  name  that  is  a  DECnet  node  name  (if 
DECnet  is  active)  or  the  system  name  that  was  selected  during  system 
generation  (if  DECnet  is  not  active).  In  the  previous  messages, 
WALNUT  is  the  6-character  name. 

SHUTUP  continues  to  issue  the  warning  messages  at  the  interval 
specified.  When  three  minutes  remain  before  system  shutdown,  SHUTUP 
changes  the  interval  between  messages  to  one  minute . 

if  the  system  supports  multiuser  protection  and  the  specified  delay 
before  disabling  logins  has  expired  (measured  from  the  time  SHUTUP  is 
started),  SHUTUP  displays  the  following  message  on  the  invokinq 
terminal : 

All  further  lodi.ns  are  disabled 

After  SHUTUP  logs  out  all  terminals,  aborts  all  nonprivileged  tasks, 
and  dismounts  all  devices,  it  displays  the  following  message  on  the 
invoking  terminal: 

S H U T UP  opera t i o n  e o m p 1 e t e 

SHUTUP  then  halts  the  processor. 

this  point,  you  can  either  bootstrap  another  system  or  resume 
operation  of  the  current  system  by  pressing  the  continue  switch  on  the 
CPU  console.  After  you  press  the  CONT  switch  (continue),  logins  are 
enabled  and  the  following  message  appears  on  the  invoking  terminal: 

Lodi ns  are  now  enabled 

To  continue  operation  of  the  current  system,  you  must  mount  the 
devices  and  follow  normal  system  startup  procedures . 


8.5  THE  SHUTUP.CMD  FILE 

The  indirect  command  file  LB: [1 , 2]SHUTUP .CMD  is  for  user-specific 
functions.  SHUTUP  submits  the  file,  if  present,  to  the  Indirect 
Command  Processor  for  execution.  The  SHUTUP  task-build  file  specifies 
the  amount  of  time  (the  time-out  interval)  that  SHUTUP.CMD  has  to 
execute.  The  default  time-out  interval  is  120  seconds  or  170 (octal). 
It  is  possible  to  change  the  time-out  interval  for  SHUTUP.CMD  in  the 
task-build  file. 

On  unmapped  RSX-11M  systems,  the  task-build  file  is  [1, 20jSHUBLD.CMD. 
On  mapped  RSX-11M  systems,  the  file  is  [1 , 24] SHUBLD.CMD. 

For  RSX-11M-PLUS  systems,  the  task-build  file  is  [1 , 24]SHUBLD .CMD. 

If  the  timeout  interval  expires  and  SHUTUP.CMD  is  not  finished,  SHUTUP 
asks  if  you  want  to  wait  for  SHUTUP.CMD  to  finish.  For  example: 

Command  (AT.)  Timeout  -  Continue  waiting?  [Y/N]: 

If  you  enter  N,  SHUTUP  continues  without  waiting  any  longer.  If  you 
enter  Y,  SHUTUP  waits  an  additional  30  seconds.  SHUTUP  continues 
without  waiting  any  longer  if  SHUTUP.CMD  has  not  finished  at  the  end 
of  the  30  seconds. 
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You  may  want  SHUTUP.CMD  to  install  ACS,  BYE,  DMO,  ELI,  and  ACC  (these 
tasks  must  be  installed  to  enable  SHUTUP  to  execute  properly) .  If  you 
have  an  RSX-11M-PLUS  system,  SHUTUP. TSK  will  install  ACS  and  ELI.  If 
DECnet  is  installed  on  your  system,  you  may  use  SHUTUP.CMD  to  shut 
down  the  network . 

The  following  is  an  example  of  a  SHUTUP.CMD  files 


{THIS  SHUTUP. CMP  F 1 1  E  INSTALLS  El. I 
{AND  ACS  IF  THEY  ARE  NOT  INSTALLED , 

; AND  ALSO  ACTIVATES  A  COMMAND  Fit  F  TO 
{SHUT  DOWN  THE  NETWORK  IF  THE  NETWORK 
{IS  ACTIVE. 

! ENABLE  SUBSTITUTION 


.  IFNI NS  ...ELI  INS  *ELI 
.  IFNINS  ...ACS  INS  $ACS 


.  IFNACT  NETACP  .GOTO  20 
8L.Btn  >  2TNETST0P 


8.6  RSX-11M  SYSTEM  SHUTDOWN 

The  following  sections  describe  the  shutdown  procedure  for  RSX-11M 
systems.  An  annotated  example  of  a  system  shutdown  supplements  the 
description . 

8.6.1  RSX-11M  System  Shutdown  Procedure 

When  the  delay  before  system  shutdown  expires,  SHUTUP  performs  the 
following  functions : 

1.  Logs  out  logged- in  terminals  (multiuser  protection  systems 
only) 

2.  Stops  the  Console  Logger  (if  active) 

3.  Redirects  the  console  terminal  to  the  TI:  of  SHUTUP 

4.  Submits  the  indirect  command  file  LB : [ 1 , 2 ] SHUTUP . CMD  (if 
present),  to  the  Indirect  Command  Processor  for  execution 

5.  Stops  the  Queue  Manager  (if  active) 

6.  Stops  the  Error  Log  Task  (ERRLOG )  (if  active) 

7.  Deallocates  checkpoint  space  and  dismounts  devices 

8.  Halts  the  processor 

At  this  point,  you  can  either  bootstrap  another  system  or  resume 
operation  of  the  current  system. 
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8.6.2  Example  of  an  RSX-11M  System  Shutdown 

The  following  is  an  example  of  an  RSX-11M  system  shutdown: 

> RUN  $ SHUTUP 

>  R  S  X  - 1 1 M  SHUT  DOWN  PROGRAM 

Enter  minutes  to  wait  before  shutdown?  1.0  (ret) 
fc. ! "i t e r  hi i i "i u t e s  b etween  messages?  3  (ret) 

Enter  minutes  to  wait  before  disabling  iodine?  5  (ret) 

OK  to  shutdown?  T Y/NT  ?  Y  © 


14-DEC- 

85 

16*  35 

P  3.  e  as  e 

f  ;i.  n  i  s  h 

U  P  f 

10 

m  :i  n  u  t  e  s 

b  e  f  o  r  e 

s  hi  u  t  d  o  w  n 

--  CASHFW 

14-DEC- 

85 

1.6:58 

P 1.  e  a  s  e 

f  :i.  n  i  s  hi 

up  ? 

7 

tit  i.  n !  1 1  e  s 

b  e  f  o  r  e 

shutdown 

—  CASHEW 

A 1 1  f  u  r  t  her  1  o  d  :i  n  s  a  r  e 

d  :i  s  a  h  3.  e  d 

14-DEC- 

85 

16:  40 

P  3.  e  a  s  e 

f  :i.  n  :i.  s  h 

U  P  ? 

5 

m  i  n  u  t  e  s 

b  e  f  o  r  e 

shu t down 

—  CASHEW 

14-DEC- 

85 

1.6t  42 

P  3.  e  a  s  e 

f  :i.  n  i  s  i  t 

UP  ? 

3 

in  i  nut  os 

b  e  f  o  r  e 

s  h  i  ,i  t  d  o  w  n 

—  CASHEW 

1 4 -DEC- 

85 

16:  43 

P  3.  e  a  s  e 

f  i  n  i  s  h 

UP  ? 

7 

in  :i  n  u  t  e  s 

b  e  f  o  r  e 

s  in  u  t  d  o  w  n 

—  CAS  H  F  W 

14  -DEC- 

85 

1. 6  :  4  4 

P  3.  e  a  s  e 

f  i.  n  i  s  h 

UP  f 

1. 

fti  i.  n  t » t  e 

b  e  f  o  r  e 

s  h  u  t  d  o  w  n 

—  CASHEW 

14-  DEC- 

85 

16:  45 

S  s  t  e  m 

i.  s  n  o  w 

s  h  u  1 1  :i  n 

s  « j  o  w  ri  - 

•  —  0  A  8  M  P  U 

SET  /C0l„0G=0FF  Q 

8LBJC1 r 23SHUTUP  Q 

>  INS  $FLI 

>  INS  $  A  C  S' 

>8  <E0  PI¬ 
QUE  /STOtGMO  0 

EL)  /N0L.0G  © 

16?46?01  ERRI..06  —  Error  Losidinsf  stopped 

ACS  D R 0  ?  / B I.  K S  =  0  .  0 

A  C  S  C  h  e  c  k  p  o  i  it  t  f  i  1  e  r  i  o  w  i  n  a  t :  t  i  v  e 

DM0  nBOJ/PFV.0 

D  M  0  S  s  s  t  e  iTi  d  i  s  k  h  e  ins!  d  :i  s  m  o  u  n  t  e  d 

DM0  —  SYSTEM  dismounted  from  0B0?  **#  Final  dismount  initiated 

1 6  ?  4 ?  ?  1 0  #  #  t  D  B  0  ?  —  P  i  s m o u n t  c o m p 1  e t e 

DM0  D S 0 ? / D E V  0 

DM0  ----  Warning  -  Tasks  installed  from  DS0J 

DM0  —  SYSTEM  dismounted  from  DSC?  *#*  Final  dismount  initiated 
1  6  *  4  7  ?  2  0  #  $  t  D  S  0  !  —  D  i  s  m  o  u  n  t  c  o  m  p  ]  e  t  e 


*** 


*** 


S  H II T  0  P  o  p  e  r  a  t  :i.  o  n  c  o  m  p  1  e  t  e  0 
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To  shut  down  the  system  in  this  example,  SHUTUP  performs  as  follows: 

Q  Stops  the  Console  Logger. 

©  Invokes  the  indirect  command  file  LB :  [ 1 , 2  ] SHUTUP . CMD . 

SHUTUP.CMD  installs  ELI  and  ACS.  The  @<EOF>  message 
indicates  the  end  of  the  command  file  SHUTUP.CMD. 

©  Stops  the  Queue  Manager. 

©  Runs  the  task  ELI  to  terminate  the  Error  Log  Task  (ERRLOG) . 

©  Deallocates  checkpoint  files  on  DBO : . 

0  Dismounts  the  disks  on  DBO:  and  DSO:. 

©  Displays  a  message  when  SHUTUP  has  finished  executing. 


8.7  RSX-1 1M-PLUS  SYSTEM  SHUTDOWN 

The  following  sections  describe  the  shutdown  procedure  for 
RSX-1 1M-PLUS  systems.  An  annotated  example  of  a  system  shutdown 
supplements  the  description. 

8.7.1  RSX-1 1M-PLUS  System  Shutdown  Procedure 

When  the  delay  before  system  shutdown  expires,  SHUTUP  performs  the 
following  functions: 

1.  Stops  the  Console  Logger  (if  active) 

2.  Redirects  the  console  terminal  to  the  TI:  of  SHUTUP 

3.  Submits  the  indirect  command  file  LB : [1 , 2 ]SHUTUP .CMD  (if 
present)  to  the  Indirect  Command  Processor  for  execution 

4.  Logs  off  logged-in  terminals  (multiuser  protection  systems 
only) 

5.  Stops  the  Queue  Manager  (if  active) 

6.  Stops  Resource  Accounting,  if  Resource  Accounting  is  active 

7.  Stops  the  Error  Log  Task  (ERRLOG)  (if  active) 

8.  Checkpoints  all  read/write  commons 

9.  Deallocates  checkpoint  space  and  dismounts  devices 

10.  Halts  the  processor 

At  this  point,  you  can  either  bootstrap  another  system  or  resume 
operation  of  the  current  system. 
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8.7.2  Example  of  an  RSX-11M-PLUS  System  Shutdown 

The  following  is  an  example  of  an  RSX-11M-PLUS  system  shutdown: 

>RUN  if  SHUT  UP 

RSX- 1 1  li-PLUS  SHUT  DOWN  PROGRAM 

Enter  minutes  to  wait  before  shutdown!  1.0  (ret) 

Enter  minutes  between  messages!  5  (ret) 

Enter  minutes  to  wait  before  disabling  logins!  2  ® 

Reason  for  shutdown  <<CR>  for  none) !  FIFLD  SFRVICF  PH 
DK  to  shutdown?  EY/NliY  © 

Oo-NGV-85  16!34  Please  finish  up  *  10  minutes  before  shutdown  -- 
Reason  for  shutdown!  FIELD  SERVICE  PM 

A 1 1  f  u  r  t  h  e  r  1  o  si  i  n  s  are  d  i  s  a  h  led 

0  J--N0V--8 b  .1  6  S  3 9  P  lease  f  j  n  i s h  up*  5  m  1  n u t e s  b e f  o  re  s h u t d o w it 
Reason  for  shutdown!  FIELD  SERVICE  PM 

05 -NOV-8 5  16! 41  Please  finish  up?  3  minutes  before  shutdown  — 
Reason  for  shutdown!  FIELD  SERVICE  F’M 

0  ..j  --  N  0  V  --  8  t  16!  4.2  Please  finish  up*  2  minutes  before  shutdown  -- 
Reason  for  shutdown!  FIELD  SERVICE  PM 

0  ,.j  -  N  0  V  -  8  5  1  c> !  4  3  Please  f  i  n  i  s  h  u  p  *  I  m  :i  n  u  t.  e  b  e  f  o  r  e  s  h  u  t  d  own  -  - 
Reason  for  shutdown!  FIELD  SERVICE  PM 

05-  N  0  V  -  8  5  1  6  !  4  4  8  a  s  t  e  m  i  s  n  o  w  s  h  u  1 t  i  n  d  d  o  w  n  •-  --  A  I.  M  0  N  D 
Reason  for  shutdown!  FIELD  SERVICE  PM 

l?  LB!  F  1  *21  SHUT  UP  Q 
> I N S  «ELI 
> INS  SACS 
>0  <E0F> 

QUE  /STO ! QMG  0 

S  T  0  P  /  A  C  C  0  U  N  T  X  M  0  8  H IJ  T  U  P  0 

ELI  /NO LOG  © 

16X501  2  0  X  E  R  R  L  0  G  -  -  F  r  r  o  r  I.  o  <K  <3  i  n  b  s  t  o  p  p  e  d 

ACS  PB7i /m  KS  =  0.  0 

A  C  S  -  -  C  h  e  c  k  p  o  i  n  t  f  i.  I  e  n  o  w  i  n  a  c  t  j.  v  e 
D  H  D  D  R  7  t  /  P  F  V  /10C  K  «  V  0 

D  M  0  -  -  S  y  s  t  e  m  d  :i  s  k  b  e  j  n  $  d  i  s  in  o  u  n  t  e  d 

DHO  SYSTEM  d  i  s  mounted  from  DB7 1  ***  Final  Dismount  Initiated 

.!.  6  X  4  /  *  3. 9  #  $  ^  D  R  7  t  —  D  :i  $  m  o  u  n  t  c  o  m  p  1  e  t  e 


S  H  U  T  U  P  □  p  e  r  a  t  :i  o  n  c  o  in  p  1  e  t  e  0 


ALMOND 

AI.MOND 

ALMOND 

AI.MOND 

ALMOND 


*  *  & 
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To  shut  down  the  system  in  this  example,  SHUTUP  performs  as  follows: 

0  Invokes  the  indirect  command  file  LB :  [  1 , 2 ] SHUTUP . CMD . 

SHUTUP.CMD  installs  ELI  and  ACS.  The  @<EOF>  message 
indicates  the  end  of  the  command  file  SHUTUP.CMD. 

0  Stops  the  Queue  Manager. 

0  Stops  Resource  Accounting . 

0  Runs  the  task  ELI  to  terminate  the  Error  Log  Task  (ERRLOG) . 

0  Deallocates  checkpoint  files  on  DB7 : . 

0  Dismounts  the  disk  on  DB7 : . 

The  Virtual  option,  /LOCK=V,  is  privileged.  When  you  specify 
the  Virtual  option,  the  DISMOUNT  command  does  not  clear 
volume  as  valid  and  does  not  spin  down  the  disk.  (Refer  to 
the  RSX-11M/M-PLUS  MCR  Operations  Manual  for  additional 
information .) 

0  Displays  a  message  when  SHUTUP  has  finished  executing 
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TERMINAL  EMULATION  AND  FILE  OPERATIONS  WITH  OTHER  SYSTEMS 


9 . 1  INTRODUCTION 

A  local  Micro/ RSX  terminal  can  log  in  to  and  conduct  an  interactive 
session  with  an  external  computer  system.  This  session  is  established 
using  the  Data  Terminal  Emulator  (DTE) •  The  external  system  can  be  an 
RSX— 1 1M  or  RSX-1 1M-PLUS  system,  a  VAX/VMS  system  running  VAX-11  RSX,  a 
Professional  Personal  Computer,  or  another  Micro/RSX  system.  Once  a 
local  Micro/RSX  terminal  is  logged  in  to  an  external  system,  the 
external  system  becomes  the  host  system.  The  host  system  views 
Micro/RSX  as  remote.  During  an  interactive  session,  files  can  be 
transferred  between  the  host  system  and  Micro/RSX.  Files  are 
transferred  using  the  Micro/RSX  File  Transfer  Utility  (MFT) . 

The  following  two  conditions  must  exist  for  terminal  emulation  and 
file  transfer  to  be  operational: 

1.  The  two  computers  must  be  connected. 

2.  The  DTE  software  must  be  installed  on  the  local  Micro/RSX 
system,  and  MFT  must  be  installed  on  the  host  system. 

Refer  to  Sections  9.1.1  and  9.1.2  for  more  detailed  information. 


9.1.1  Connecting  Two  Computers 

The  two  computers  can  be  connected  either  on-site  or  at  remote  sites 
through  an  asynchronous  serial  line.  A  Micro/RSX  system  is  connected 
to  an  on-site  external  system  by  a  cable  and  to  a  remote  system  by 
DF03  modems  and  a  telephone  line.  In  either  case,  there  is  a 
dedicated  line  between  the  two  systems  that  establishes  the  ports  at 
each  end  of  the  line,  assigned  specifically  for  terminal  emulation  and 
data  transfer. 

A  direct  hardwired  connection  between  two  systems  can  be  established 
by  plugging  one  end  of  a  cable  into  the  communications  port  in  the 
back  of  the  local  system  unit,  and  the  other  end  of  the  cable  to  a 
host  system.  A  permanent  connection  can  also  be  established  by  using 
a  DIGITAL  Model  H312A  null  modem  cable  and  two  standard  EIA  RS-232 
connectors.  When  the  two  systems  are  directly  connected  with  a  cable, 
the  terminal  characteristics  of  the  port  at  the  local  Micro/RSX  system 
should  be  set  to  SLAVE  and  NOECHO.  This  prevents  the  transmission  of 
extraneous  noise  signals  when  the  port  is  idle  (disconnected  from 
terminal  emulation) •  Noise  signals  can  create  intersystem  echo  loops 
that  seriously  affect  system  performance. 


9-1 


TERMINAL  EMULATION  AND  FILE  OPERATIONS  WITH  OTHER  SYSTEMS 


Transmission  speed  between  systems  varies  depending  on  the  systems 
involved.  Variations  are  based  on  the  following: 


•  Processor  type 

•  Interface  type 

•  System  load 

•  Distance  between  systems 


•  Terminal  support  (use  of  higher  baud  rates  requires  that  the 
remote  system  support  XON/XOFF  protocol) 


If  XON/XOFF  is  present,  your  terminal  may  run  at  a  speed  lower  than 
that  of  the  physical  connection.  For  consistent  performance,  use  a 
baud  rate  of  2400  for  Micro/RSX. 


The  following  figures  show  typical  configurations  for  a  Micro/RSX 
system. 


TT3: 

Micro/RSX 

System  i 

1 

▼ 

DTE  Program 

1 

TT5: 

■-►DZV11 

1 

1 

User  Terminal 


Connecting  Ports 
(both  set  to  same  baud  rate) 


TT30: 


Local  PDP-11 
or  VAX 
System 


I 


MFT  Program 


n. 


I  DZ1 
I 


j 


ZK-41 25-85 


Figure  9-1  Terminal  Emulation  with  an  On-Site  System 


ZK-4126-85 


Figure  9-2  Terminal  Emulation  with  a  Remote  System 


In  these  example  configurations,  when  the  local  Micro/RSX  user 
terminal  (TT3 : )  is  in  terminal  emulation,  the  following  conditions 
exist : 

•  TT3:  is  connected  to  port  TT5 :  using  the  DTE  software. 

•  Port  TT5:  is  connected  to  port  TT30:  in  a  PDP-11  system. 
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•  Port  TT5 :  is  a  connector  on  a  DZV11. 

•  Port  TT30:  is  a  connector  on  a  DZ11 . 

Note  that  port  TT5:  is  set  using  the  following  command  line: 

$  SFT  TERMINAL  TT5J/SI.  AVF/NOFCH0 


9.1.2  Location  of  DTE  and  MFT 

There  are  two  separate  programs  that  support  Micro/RSX  terminal 
emulation  and  file  transfer.  One  resides  in  the  local  Micro/RSX 
system  and  the  other  resides  in  the  host  system.  DTE,  which  is  in  the 
Micro/RSX  system,  establishes  the  local  terminal  as  an  emulated 
terminal.  Establishing  terminal  emulation  means  connecting  a  local 
Micro/RSX  terminal  to  an  external  system  so  that  the  local  Micro/RSX 
terminal  can  be  logged  in  as  a  user  of  the  host  system. 

The  other  program  is  MFT  which  interfaces  with  DTE  when  file 
operations  are  initiated  at  a  local  terminal .  The  MFT  software  is 
executed  on  the  external  computer  system  (the  host)  that  is  connected 
to  the  Micro/RSX  system. 

DTE  and  MFT  tasks  are  separate  tasks  that  work  together,  but  execute 
on  two  physically  different  systems.  Also,  note  that  all  user  key-ins 
are  done  at  a  terminal  connected  to  the  local  Micro/RSX  system. 


9.2  ESTABLISHING  TERMINAL  EMULATION 

Once  you  have  determined  that  the  two  specified  computers  are 
connected  and  that  both  DTE  and  MFT  are  installed  on  their  respective 
systems,  you  can  establish  terminal  emulation.  To  establish  a 
connection  between  Micro/RSX  and  another  system,  use  the  following 
command  line : 

SET  HOST/DTE  device: /MUTE 

where  device  is  the  Micro/RSX  device  and  unit  specification  of  the 
terminal  port  used  for  terminal  emulation.  Specifying  the  /MUTE 
qualifier  ensures  that  the  terminal  is  set  to  SLAVE  and  NOECHO  upon 
exiting  from  terminal  emulation. 

The  following  command  example  establishes  terminal  emulation: 

$  SET  HOST/DTE  TT5J/HUTE 

This  DCL  command  runs  the  DTE  task,  which  establishes  terminal 
emulation  by  connecting  your  terminal  to  port  TT5 : .  When  data 
terminal  emulation  is  terminated,  port  TT5 :  is  set  to  SLAVE  and 

NOECHO.  After  you  type  this  command  (and  follow  it  with  a  RETURN), 
you  are  connected  to  the  host  system.  You  can  then  log  on  as  a  user 
of  that  system  and  use  the  file  transfer  utility  (see  Section  9.3). 

To  terminate  emulation,  type  the  LOGOUT  command  from  the  host  system. 
Then,  press  and  hold  the  control  key  (CTRL)  and  type  a  P  character. 
The  following  message  is  displayed: 

%  D T  E -  S  -  E  M  UE X I T  *  E m u  1  s t :i  o n  e x itinst«*«  Please  wait 

You  are  then  returned  to  command  level  execution  at  the  local 
Micro/RSX  system. 
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NOTE 

Be  sure  that  you  log  out  from  the  host  system  before 
exiting  terminal  emulation.  If  you  are  in  terminal 
emulation  and  press  CTRL/P  before  logging  out  from  the 
host  system,  the  terminal  connection  is  returned  to 
the  local  Micro/RSX  system.  The  host  system  remains 
logged  in  to  your  account.  Under  these  conditions,  if 
another  user  initiates  terminal  emulation,  that  user 
will  be  logged  in  to  the  host  system  under  your 
account . 

To  use  DTE  from  the  system's  console  terminal,  you 
must  first  disable  the  console  On-Line  Debugging  Tool 
(ODT ) .  Both  console  ODT  and  DTE  use  the  CTRL/P 
character. 


9.2.1  DCL  Command  Syntax 

The  DCL  SET  HOST/ DTE  command  qualifiers  provide  options  that  allow  you 
to  do  the  following: 

•  Dial  out  to  the  remote  system  through  the  DF03  modem 

•  Specify  the  terminal  as  mute  (SLAVE/NOECHO)  on  termination 

•  Display  the  version  of  the  DTE  task 
The  SET  HOST/DTE  command  line  is  as  follows: 

SET  HOST/DTE  device: [/options] 

The  options  are  as  follows: 

/DIAL=" ..." 

Allows  the  specification  of  a  dial  command  string  for  the  DF03 
modem.  The  string  may  consist  of  any  of  the  digits  0  through  9,  and 
the  equal  sign  (=) .  The  equal  sign  indicates  that  another  dial  tone 
is  expected  (for  example,  when  you  dial  from  an  internal  telephone 
system  to  an  outside  telephone  number). 

/MUTE 


Specifies  whether  DTE  should  alter  certain  device  characteristics 
prior  to  exiting.  The  default  is  to  return  all  of  the  device 
characteristics  to  their  original  states.  However,  if  the  device 
is  set  NOSLAVE/ECHO,  it  is  possible  that  noise  characters  can 
create  intersystem  echo  loops,  which  can  severely  affect 
performance.  Therefore,  it  is  recommended  that  either  the  device 
be  set  to  SLAVE/NOECHO,  when  it  is  idle  (DTE  will  change  these 
characteristics),  or  that  the  /MUTE  option  be  specified,  which 
will  set  the  device  to  SLAVE/NOECHO  when  DTE  exits . 

/VERSION 

Displays  the  version  of  the  DTE  task. 
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9.2.2  Examples 

Following  are  examples  using  the  SET  HOST/DTE  command. 

$  SET  HOST /DTE  TT404* 

This  example  invokes  DTE  to  establish  terminal  emulation  using 
terminal  TT40: . 

*  SFT  HOST/DTF  TT50 J /P T At = ■ 5550837 1 


This  example  initiates  terminal  emulation  using  terminal  TT50:,  after 
directing  the  DF03  modem  to  dial  the  specified  number  and  establish  a 
modem  connection. 

$  SET  HOST/DTE  TT2f5 1 /MUTE 


This  example  establishes  terminal  emulation  using  terminal  TT25 : ,  and 
sets  the  terminal  characteristics  to  SLAVE/NOECHO  on  termination. 


9.3  PERFORMING  FILE  OPERATIONS 

The  MFT  utility  is  used  to  delete  and  transfer  files  between  a 
Micro/ RSX  system,  using  terminal  emulation  and  the  host  system  that 
the  local  Micro/RSX  is  logged  in  to.  Special  code  in  the  DTE  task  is 
used  to  identify  and  perform  local  file  operations  requested  by  the 
MFT  task.  File  transfer  is  performed  using  an  error  detection  and 
correction  algorithm  to  ensure  data  integrity.  The  speed  of  file 
transfer  varies  with  the  processor  and  interface  types,  system  load, 
and  software . 


NOTE 

Support  for  variable  typeahead  buffer  size  allows  for 
higher  transfer  rates. 

Your  local  terminal  is  locked  out  during  file  transfer  operations  to 
prevent  interference  with  the  data  transfer  between  the  two  systems. 
You  are  returned  to  terminal  emulation  when  the  file  operation 
completes . 

The  command  syntax  used  to  perform  file  operations  depends  on  the  host 
operating  system. 


9.3.1  MCR  Command  Syntax 

If  the  host  system  is  an  RSX-11M  or  RSX-11M-PLUS  system,  or  a  VAX/VMS 
system  running  VAX-11  RSX,  you  use  MCR  commands  to  execute  MFT  as 
follows  s 

>MFT 

The  host  system  responds  with  the  followings 


MFT> 
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You  can  now  copy  files  from  one  system  to  the  other ,  in  either 
direction.  To  do  this,  use  the  following  syntax  to  indicate  the  files 
that  you  wish  to  copy: 

MFT>  to  file[/REM]=from_file[/REM] 


where : 

to  file 


from  file 


/REM 


The  output  file  or  where  the  file  is  being  copied 
to. 

The  input  file  or  where  the  file  is  being  copied 
from. 

Means  remote;  is  used  to  indicate  that  the  file  is 
on  the  local  Micro/RSX  system  that  is  remote  to  the 
host  system. 


If  you  want  to  copy  from  the  host  to  the  Micro/RSX  system,  the  syntax 
is  as  follows: 

> MFT  MESSAGE. TXT/ REM=HOST. TXT 

If  you  want  to  copy  from  the  Micro/RSX  system  to  the  host,  the  syntax 
is  as  follows: 


> MFT  MESSAGE. TXT=MICRO. TXT/REM 
To  delete  files,  use  the  following  syntax: 

MFT>  delete_file[ /options] 
where: 

delete  file  The  name  of  the  file  to  be  deleted. 

/options  /DE  indicates  the  file  is  to  be  deleted. 

/REM  indicates  the  file  is  on  the  Micro/RSX  system 
remote  to  the  host  system.  The  absence  of  /REM 
indicates  the  file  is  on  the  host  system. 

You  cannot  specify  wildcards  when  using  MFT  to  delete  files . 

A  sample  file  transfer  session  follows: 


$  SET  HOST  / DTE  T T 5  ♦  (ret) 

> LOG IN 

> ACCOUNT  OR  NAME:  user 
> PASSWORD*  p a s  s  w o r  d 


>  H  F  T 

MFT>  MESSAGE.  ♦  TXT^M I CRG  ♦  TXT/ REM 

%DTE-S-MFTINIT  9  File  operation  initiated 
%DTE-S~MFTCOMP>  File  operation  complete 

ffi) 
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(The  cursor  will  be  at  the  beginning  of  the  last  message.  To 
continue  the  operation,  press  RETURN.) 

M  F  T  > 


> LOGOUT 

<• 

' 


@RL/P) 


%  D  f  F  ~  8  -  F  M  U  F  X  T  T  ->  F  m  u  I  a  t  :i.  o  n  e  :i  t  i  n  &  ♦  ♦  ♦  Please  w  a  :i  t 
$ 

In  order  to  use  MFT ,  you  must  be  using  the  DTE  task,  because  the 
protocol  used  for  the  file  operations  is  unique  to  the  two  tasks. 


9.3.2  DCL  Command  Syntax 

If  the  host  system  is  a  Micro/RSX  system,  you  use  the  following  DCL 
command  syntax  to  perform  file  operations: 

COPY  from_file[ /option]  to_file[ /option] 

DELETE  f ile[ / option] 

where : 


from_f ile  The  name  of  the  input  file  that  MFT  is  to  transfer. 


to  file 


/ option 


file 


The  name  of  the  output  file  to  which  MFT  is  to  copy 
the  input  file  (from_file). 

/REM  (remote)  is  used  to  indicate  that  the  file  is 
on  the  local  Micro/RSX  system  that  is  remote  to  the 
host  system.  The  absence  of  /REM  indicates  the  file 
is  on  the  host  system. 

The  file  name  of  the  file  to  be  deleted. 


NOTE 


For  input  files,  /REMOTE  indicates  that  the  file 
resides  on  the  DTE  system.  For  output  files,  /REMOTE 
indicates  that  the  output  file  should  be  created  on 
the  DTE  system.  When  using  the  DELETE/REMOTE  command, 
the  file  to  be  deleted  should  be  deleted  on  the  DTE 
system. 
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9.3.3  Examples 

Following  are  examples  of  file  operations  using  the  DTE  and  MFT 
programs . 

$  COPY  INF II  F  .  OAT  OUT F 1 1.  F ♦ DAT/RFMOTF 

This  example  copies  the  file  INFILE . DAT  from  the  host  (MFT)  system 
into  OUTFILE.DAT  on  the  remote  (DTE)  system. 

$  COPY  INFII.E  ♦DAT/REMOTE  OUTFILE.DAT 

This  example  copies  the  file  INFILE . DAT  from  the  remote  (DTE)  system 
into  OUTFILE.DAT  on  the  host  (MFT)  system. 

$  delete  file.dat/rfhote 

This  example  deletes  the  file  FILE . DAT  on  the  remote  (DTE)  system. 

9.4  MESSAGES 

The  following  sections  list  and  describe  the  messages  produced  by  DTE 
and  MFT. 


9.4.1  DTE  MESSAGES 

The  following  messages  are  produced  by  DTE.  Some  messages  also 
include  a  6-character  octal  field  enclosed  in  parentheses.  This  field 
provides  additional  internal  information  regarding  the  cause  of  the 
error,  but  is  generally  not  useful  to  you  unless  the  information  is 
also  mentioned  in  the  message  description. 

?DTE-F-DEVTYPE,  Illegal  device  type  for  DTE 

DTE  assigned  the  specified  emulation  device  and  found  that  it  was 
not  a  terminal.  DTE  can  be  used  only  on  terminal  devices. 

%DTE-S-DF03SEQ ,  Dialing...  Please  hold 

The  DTE  /DIAL  option  has  been  specified,  and  DTE  is  attempting  to 
establish  a  connection  using  a  DF03  modem  (which  is  assumed 
present  on  the  specified  emulation  terminal  line) .  Your  terminal 
is  locked  out  until  the  DF03  responds  with  either  success  or 
failure . 

7DTE-F-DF03TMO,  Telephone  connection  failure  due  to  timeout 

DTE  sent  the  dial  sequence  specified  by  the  /DIAL  option,  and  the 
DF03  modem  (which  was  assumed  to  be  present)  did  not  respond 
within  40  seconds.  DTE  will  attempt  to  hang  up  the  line  and  then 
exit  in  error. 

%DTE-S-DIALHNG,  Dialup  line  hung  up 

DTE  is  attempting  to  hang  up  the  specified  emulation  terminal 
that  is  connected  to  a  DF03  modem.  It  may  or  may  not  have 
succeeded  in  hanging  up. 
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%DTE  I-DTETVER,  Data  Terminal  Emulator  Version  x.y  [dd— mmm— yy] 

DTE  displays  its  version  number  if  the  /IDENTIFICATION  option  was 
selected  on  the  command  line . 

%DTE-S-EMUEXIT ,  Emulation  exiting...  Please  wait 

A  CTRL/P  was  typed  on  your  terminal,  and  DTE  has  begun  exit 
processing.  Your  terminal  is  locked  out,  all  DTE  I/O  processing 
is  being  completed,  and  all  device  characteristics  are  being 
restored.  This  operation  takes  approximately  5  seconds. 

7DTE-F-ERDDCMP,  Transmission  [DDCMP]  failure  (xxxxxx) 

During  DTE/MFT  file  transfer,  a  DDCMP  error  occurred  that  could 
not  be  corrected  after  several  retries.  The  physical  (emulation) 
terminal  lines  are  producing  too  many  errors  for  a  file  operation 
to  be  performed.  Usual  causes  for  this  behavior  are  baud  rates 
that  are  too  high,  systems  that  are  too  far  apart  (physical  cable 
length  must  be  considered),  a  lack  of  the  required  terminal 
support,  or  some  form  of  electrical  interference  (noise)  along 
the  physical  connection  (because  of  a  bad  telephone  connection, 
heavy  electrical  equipment,  and  so  forth). 

7DTE-F-FATALER,  Internal  error  (xxxxxx) 

DTE/MFT  has  encountered  an  unexpected  internal  condition.  This 
message  indicates  a  bug  in  the  local  file  operations  server 
within  the  DTE  task. 

%DTE-S-MFTCOMP ,  File  operation  complete 

A  DTE/MFT  file  operation  has  completed,  and  control  has  been 
returned  to  your  terminal.  If  the  operation  has  completed  in 
failure,  then  this  message  will  be  preceded  by  an  error  message 
showing  the  cause  of  the  file  operation  failure. 

%DTE-S-MFTINIT,  File  operation  initiated 

DTE  has  received  the  handshake  sequence  from  the  MFT  task  on  the 
other  system.  DTE  invokes  the  file  transfer  server  to  provide 
local  support  for  the  operation  being  initiated  on  the  remote 
system.  Your  terminal  is  locked  out  until  the  operation 
completes . 

7DTE-F-MSGF0RM,  Message  format  error  (xxxxxx) 

The  version  of  the  MFT  file  server  within  the  DTE  task  is  not 
compatible  with  the  version  of  the  MFT  task  on  the  remote  system. 
This  may  be  caused  by  an  error  in  the  remote  MFT  task,  or  by  an 
incompatibility  of  releases  of  DTE  and  MFT. 

7DTE-F-N0TSELD,  Terminal  line  not  selected 

This  is  an  internal  error,  and  indicates  that  the  LUN  has  been 
lost . 

%DTE-S-PHONEOK,  Telephone  connection  established 

DTE  sent  the  dial  sequence  specified  by  the  /DIAL  option,  and  the 
DF03  modem  responded  with  success  (it  returned  the  character 
"A").  The  connection  to  the  remote  system  has  been  successfully 
established . 
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7DTE-F-PHONERR,  Failure  to  establish  telephone  connection 

DTE  sent  the  dial  sequence  specified  by  the  /DIAL  option,  and  the 
DF03  modem  did  not  respond  with  success.  DTE  will  hang  up  the 
line  and  then  exit  in  error. 

7DTE-F-P0RTSEL ,  Assignment  failure  on  specified  device 

DTE  attempted  to  assign  and  attach  the  specified  emulation 
terminal  device,  and  was  not  able  to.  The  device  may  be  attached 
by  another  user,  or  may  be  an  inappropriate  device  type  for 
emulation . 

7DTE-F-REJ0PER,  Operation  rejected  (xxxxxx) 

The  file  operations  server  within  the  DTE  task  cannot  perform  the 
operation  requested  by  the  MFT  task  executing  on  the  remote 
system.  Either  the  DTE  task  lacks  the  required  support,  or  the 
version  of  the  remote  MFT  task  does  not  match  the  version  of  DTE 
being  used  on  the  local  system. 

7DTE-F-RMSRERR,  Remote  RMS-11  error  (xxxxxx) 

An  error  occurred  during  the  attempt  to  perform  the  file 
operation.  The  RMS-11  error  code  (in  octal)  is  displayed  within 
the  paired  parentheses. 

7DTE-F-SYNL0ST ,  Synchronization  lost  (xxxxxx) 

Synchronization  has  been  lost  between  the  local  DTE  and  the 
remote  MFT  tasks .  This  may  be  related  to  the  baud  rate  of  the 
emulation  terminal  lines  or  the  systems 1  loads .  Retry  the 
operation . 

7DTE-F-SYNXERR,  Syntax  error 

The  syntax  of  the  DTE  command  either  was  not  appropriate  or  did 
not  fit  the  documented  syntax.  Correct  the  command  and  try 
again . 

7DTE-F-UNSPR0T ,  Unsupported  protocol  operation  (xxxxxx) 

The  version  of  DDCMP  being  used  by  the  local  DTE  file  operations 
server  and  the  remote  MFT  task  are  not  compatible.  The  versions 
of  DTE  and  MFT  are  not  compatible,  and  the  requested  operation 
cannot  be  performed. 


9.4.2  MFT  MESSAGES 

The  following  messages  are  produced  by  MFT.  Some  messages  also 
include  a  " .  .  . "  field.  This  indicates  that  all  or  part  of  the  command 
line  will  be  displayed  with  the  message. 

7MFT-F-BAD0PER,  Illegal  option  specified:  ... 

A  nonexistent  or  illegal  option  was  specified  on  the  command 
line,  or  the  option(s)  selected  is  out  of  context. 

7MFT-F-C0MFILE ,  Unable  to  open  specified  command  file 

MFT  was  unable  to  access  the  specified  command  file.  No  details 
as  to  the  reason  for  the  failure  are  available.  Typical  reasons 
for  this  message  are  file  not  found,  protection  violations,  and 
so  on . 
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7MFT-F-FOPFAIL,  File  operation  failed 

The  particular  file  operation  specified  could  not  be  performed. 
There  are  many  possible  causes  for  the  failure.  Typically,  this 
message  is  produced  when  MFT  is  unable  to  synchronize  with  the 
file  operations  server  it  requests  DTE  to  invoke.  Other  possible 
causes  include  baud  rates  that  are  too  high,  systems  that  are  too 
far  apart  (physical  cable  length  must  be  considered) ,  a  lack  of 
the  required  terminal  support,  or  some  form  of  electrical 
interference  (noise)  along  the  physical  connection  (because  of  a 
bad  telephone  connection,  heavy  electrical  equipment,  and  so 
forth) . 

?MFT-F-ILLNODE,  Illegal  node  combination:  ... 

The  MFT  command  string  specifies  both  file  specifications  on  the 
same  system.  Either  /REM  appears  on  both  file  specifications  or 
does  not  appear  on  either  specification.  This  is  illegal, 
because  each  file  specification  must  specify  a  different  system. 

7MFT-F-LINELEN,  Command  line  too  long 

The  command  line  specified  was  too  long  for  the  command  buffer. 
Because  some  of  the  command  may  have  been  lost,  the  entire 
command  is  considered  invalid. 

7MFT-F-SPECERR,  Error  in  file  specification:  ... 

One  or  both  of  the  file  specifications  supplied  are  in  error. 
File  specification  syntax  is  limited  to  the  standard  RSX-11 
format,  which  is  "device : [uic] filename .type; version" . 

7MFT-F-SYNXERR,  Syntax  error: 

The  syntax  of  the  command  line  specified  is  in  error.  Possible 
causes  may  be  illegal  options,  missing  input  or  output  file 
specifications,  or  an  error  in  the  file  specification  syntax. 
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CHAPTER  10 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


This  chapter  begins  with  a  brief  introduction  to  the 
Console  Routine  (VMR)  and  continues  with  the  following 


Virtual 

sections 


Monitor 


•  Starting  VMR 


•  VMR  Command  Syntax 


•  VMR  File  Specifications 


•  VMR  Command  Descriptions 

•  VMR  Error  Messages 

^  ru  familiar  with  VMR'  you  may  want  to  skip  directly  to  Section 

10.5,  which  is  called  VMR  Command  Descriptions.  Section  10.5  contains 
command  definitions,  a  list  of  parameters  and  keywords  you  can  use  for 
each  command,  and  examples  of  the  commands. 


10.1  INTRODUCTION  TO  VMR 


VMR  is  a  privileged  system  task  that  allows  you 
RSX-11M  or  RSX-11M-PLUS  system  image  file. 


to  configure  an 


VMR  commands  are  a  subset  of  Monitor  Console  Routine  (MCR)  commands. 
VMR  commands  differ  from  MCR  commands  in  that  VMR  commands  are 
directed  to  the  disk  image  of  a  system  rather  than  to  the  current 
running  system.  The  system  image  file  that  you  configure  by  using  VMR 
commands  can  later  be  bootstrapped. 


There  are  three  types  of  VMR  commands:  initialization,  informational, 
and  task  control.  Table  10-1  contains  a  list  of  VMR  commands  grouped 
according  to  the  function  they  perform. 

See  Section  10.5  for  a  description  of  each  VMR  command. 


10.2  STARTING  VMR 

You  can  use  three  methods  to  start  VMR.  These  methods  are  described 
in  the  following  sections.  Before  you  start  VMR,  however,  you  must 
first  assign  SY:  and  LB:  to  the  device  that  holds  the  system  image 
f11®  y°U  want.to  modify*  The  symbol  definition  file  that  corresponds 
to  the  system  image  file  must  meet  the  following  requirements: 

•  It  must  have  the  same  file  name  as  the  system  image  file 

•  It  must  have  a  file  type  of  .STB 
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•  It  must  reside  on  the  same  device  and  in  the  same  directory  as 
the  system  image  file 


The  symbol  definition  file  is  not  necessary  if  you  use  the  /IM  switch. 
(See  Section  10.4  for  a  description  of  the  /IM  switch.) 

Once  you  have  corresponding  system  image  and  symbol  definition  files, 
you  can  start  VMR.  The  methods  for  starting  VMR  are  described  in  uhe 
following  sections . 


Table  10-1 

Functional  List  of  VMR  Commands 


Type  of  Command 

Command  Name 

Initialization  Commands 

ASSIGN 

CONFIGURATION 

INSTALL 

LOAD 

REDIRECT 

SAVE 

SET 

TIME 

UNLOAD 

Task  Control  Commands 

ALTER 

CANCEL 

FIX-IN-MEMORY 

REASSIGN 

REMOVE 

RUN 

UNFIX 

Informational  Commands 

DEVICES 

LUNS 

PARTITIONS 

TASKLIST 

10.2.1  Method  1:  Running  VMR 

To  run  VMR,  enter  one  of  the  following  command  lines: 

>RUN  VMR 


or 


>VMR 

VMR  responds  by  requesting  the  name  of  the  system  image  file 
you  want  to  modify: 

E  n  1 0  r  f  i  1  e  n  a  m  e  ; 

Once  you  enter  the  name  of  the  system  image  file,  VMR  opens  and 
reads  the  symbol  definition  file.  Then,  VMR  opens  the  system 
image  file  and  verifies  that  the  file  is  actually  a  system 
image . 
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Next,  VMR  displays  the  following  prompt: 

V  M  R  > 

Enter  any  VMR  command,  or  exit  from  VMR  by  pressing  CTRL/Z. 

On  RSX— 11M— PLUS  systems,  if  the  system  image  file  you  specify 
has  Executive  data  space  support,  VMR  displays  the  following 
messages  before  issuing  the  prompt: 

L  o  a  d  i  n  s$  F  x  e  c  u  t  :i  v  e  d  at  a  spar  e 
Data  space  loading  completed 


10.2.2  Method  2:  Installing  and  Running  VMR  from  LB: 

To  install  and  run  VMR,  enter  the  following  command: 

>R  II N  $  VMR 

The  system  installs  VMR  from  the  pseudo  device  LB:  under  the 

system  directory  or  library  directory,  and  then  loads  it.  On 
RSX-11M  systems,  the  system  directory  is  usually  [1,50]  for 
unmapped  systems  and  [1,54]  for  mapped  systems.  On 
RSX-11M-PLUS  systems,  the  library  directory  is  usually  [3,54]. 

Next,  VMR  responds  by  requesting  the  name  of  the  system  image 
file  you  want  to  modify: 

Enter  f  i.  lename  t 

Once  you  enter  the  name  of  the  system  image  file,  VMR  opens  and 
reads  the  symbol  definition  file.  Then,  VMR  opens  the  system 
image  file  and  verifies  that  the  file  is  actually  a  system 
image . 

Next,  VMR  displays  the  following  prompt: 


V  M  R  > 


Enter  any  VMR  command,  or  exit  from  VMR  by  pressing  CTRL/Z. 

On  RSX-11M-PLUS  systems,  if  the  system  image  file  you  specify 
has  Executive  data  space  support,  VMR  displays  the  following 
messages  before  issuing  the  prompt: 

1... o s d :i  r i £  E *a e e u  1  :i  v e  data  space 
D  a  t  a  a  p  a  e  e  1  o  a  d  i  n  a  c  o  m  p  1  e  t  e  d 


10.2.3  Method  3:  Running  VMR  While  Specifying  an  Indirect  Command  File 

To  run  VMR  while  specifying  an  indirect  command  file,  type  VMR 
followed  by  a  space,  then  enter  an  at  sign  (@)  followed  by  the 
name  of  the  indirect  command  file.  The  first  line  of  the 
indirect  command  file  must  contain  the  name  of  the  system  image 
file  you  want  to  modify.  For  example: 

>UMR  ©TASKS *CMD 

The  system  loads  VMR,  and  then,  VMR  executes  the  indirect  command 
file.  VMR  then  exits. 
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Once  you  have  started  VMR,  you  can  execute  an  indirect  command 
file  any  time  VMR  prompts  for  input.  Indirect  command  files  are 
useful  when  you  want  to  repeat  a  series  of  commands  for  several 
different  systems  (INSTALL  commands  for  example). 

To  execute  an  indirect  command  file  in  VMR,  enter  an  at  sign  (@) 
followed  by  the  name  of  the  indirect  command  file  any  time  that 
VMR  prompts  for  input .  For  example : 

VhR>  @T ASKS ♦ CMD 

VMR  executes  the  indirect  command  file,  extracting  command  input 
from  the  specified  file  until  it  reaches  the  end  of  the  file  and 
then  returns  to  the  terminal  for  further  input. 

VMR  supports  two  levels  of  indirect  command  files.  This  means 
you  can  invoke  a  second  indirect  command  file  from  within  the 
first  indirect  command  file.  However,  if  you  try  to  invoke  a 
third  indirect  command  file  from  within  the  second  indirect 
command  file,  you  receive  an  error  message. 


10.3  VMR  COMMAND  SYNTAX 

The  following  sections  describe  how  to  format  VMR  commands  and  how  to 
enter  comments  in  VMR  command  lines. 


10.3.1  VMR  Command  Format 


VMR  command  lines  can  contain  a  command  name,  parameter,  keyword(s) 
and  keyword  value(s).  The  components  of  a  VMR  command  line  are 
described  as  follows: 

Command  Name 

The  name  of  the  VMR  command. 

You  can  abbreviate  all  VMR  command  names  to  3  characters . 
VMR  accepts  3  characters  and  then  searches  for  a  space  or 
tab  followed  by  the  command  parameter  or  by  a  RETURN  if 
there  are  no  parameters .  Note  that  VMR  does  not  permit 
embedded  spaces  or  tabs  in  command  names . 

Parameter 

The  parameter  for  the  command . 

Certain  VMR  commands  require  parameters .  VMR  parameters  can 
be  file  specifications,  keywords,  devices,  or  task  names. 
You  must  always  precede  a  parameter  with  a  space  or  tab. 

Keyword 

One  or  more  keywords  for  the  command . 

VMR  keywords  are  command  specific.  Most  VMR  keywords  are 
preceded  by  a  slash  (/) .  Some  VMR  commands  permit  more  than 
one  keyword  per  command  line. 
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VMR  keywords  can  be  placed  in  any  order  in  a  command  line 
and  still  have  the  same  meaning.  For  example,  the  command: 

Vi'1R>  IMP  TEST  •  TSK/TASK»SUPFR/PMn»YFS 

has  the  same  meaning  as: 

vmr>ins  test*tsk/pmg=yes/task=sijper 


Keyword  Value 

The  value  for  the  keyword. 

You  must  always  precede  a  keyword  value  with  an  equal  sign 
(=)  or  colon  (:).  In  the  following  command  line,  =SUPER  is 
the  keyword  value  assigned  to  the  keyword  /TASK. 

M H R > IMP  T F P T ♦ TSK / T A P K - P U p E R 


10.3.2  Including  Comments  in  VMR  Commands 

VMR  interprets  an  entire  line  of  text  as  a  comment  if  the  first 
character  in  the  line  is  a  semicolon  (;).  For  example: 

M M R >  THIS  LINE  IS  A  COMMENT 

To  insert  a  comment  within  a  command  line,  use  an  exclamation  point 
(I)  at  the  start  of  the  comment,  and  an  exclamation  point  or  RETURN  at 
the  end  of  the  comment.  VMR  ignores  all  text  between  the  two 
exclamation  points  or  between  the  exclamation  point  and  the  RETURN. 
For  example : 

MMR>T AS  '.THIS  IS  A  COMMENT  STRING  @ 

Comments  are  especially  useful  to  clarify  command  lines  in  VMR 
indirect  command  files. 


10.4  VMR  FILE  SPECIFICATIONS 

VMR  accepts  the  standard  RSX-11M/M-PLUS  file  specification  format: 

ddnn : [directory] filename . type ; ver[ /IM] 

The  components  of  VMR  file  specifications  are  described  as  follows: 
ddnn : 

The  name  of  the  device  on  which  the  file  is  located. 

A  device  name  consists  of  two  ASCII  characters  (dd), 
followed  by  an  optional  1-  to  3-digit  octal  unit  number 
(nn) .  You  must  include  a  colon  (:)  at  the  end  of  the  device 
name .  For  example : 

DM1: 

The  default  device  in  VMR  is  SYO : . 
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[directory] 

The  directory  in  which  the  file  is  located. 

There  are  two  types  of  directories  in  VMR,  numeric  and 
named.  A  numeric  directory  contains  two  octal  numbers,  from 
1  to  377,  separated  by  a  comma  and  enclosed  in  square 
brackets  ([  ]).  For  example: 

[1,54] 

Named  directories  are  valid  on  RSX-11M-PLUS  systems  only.  A 
named  directory  consists  of  1  to  9  alphanumeric  characters, 
enclosed  in  square  brackets  ([  ])•  For  example: 

[IGGY] 

If  you  do  not  specify  a  directory,  the  system  defaults  to 
the  directory  under  which  VMR  is  currently  running. 

filename 

The  name  of  the  file. 

In  VMR,  a  file  name  can  consist  of  up  to  9  alphanumeric 
characters.  For  example: 

RSX11M 

There  is  no  default  file  name  in  VMR. 


type 


The  type  of  file. 

VMR  file  types  can  consist  of  1  to  3  alphanumeric 
characters.  You  must  precede  a  file  type  with  a  period  (.). 
For  example : 

.SYS 

File  types  are  optional •  However ,  omitting  a  file  type  may 
cause  VMR  to  assign  one  by  default.  VMR  assigns  default 
file  types  to  the  following  files: 


System  Image  File 

.SYS 

Task  Image  File 

.TSK 

Indirect  Command  File 

.CMD 

ver 


The  version  number  of  the  file. 

A  version  number  helps  differentiate  files  that  would 
otherwise  have  identical  file  specifications.  Always 
precede  a  version  number  with  a  semicolon  (?).  For  example: 


7  2 

On  RSX-11M  systems,  the  version  number  is  a  number  from  0  to 
77777 (octal ) .  On  RSX-11M-PLUS  systems,  if  you  select 
support  for  decimal  version  numbers  during  system 
generation,  the  version  number  is  a  number  from  1  to 
32767 (decimal) . 


10-6 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


If  you  do  not  specify  a  version  number  for  a  file,  the 
system  defaults  to  the  highest  version  number  of  that  file 
in  the  directory. 

/IM 

A  switch  that,  when  added  to  the  specification  for  the 
system  image  file,  overrides  the  VMR  requirement  for  the 
symbol  definition  file.  If  you  use  the  /IM  switch  when  you 
specify  a  system  image  file,  the  only  command  VMR  accepts  is 
the  SAVE  command . 

You  use  the  /IM  switch  to  write  non-RSX-llM/M-PLUS  system 
images  to  secondary  media  in  bootable  format.  The  /IM 
switch  is  also  useful  when  you  use  an  RSX-11M/M-PLUS  system 
as  a  host  system  for  developing  small,  memory-resident 
systems  that  must  be  loaded  from  a  serial  medium,  such  as 
paper  tape. 


10.5  VMR  COMMAND  DESCRIPTIONS 

The  following  pages  include  descriptions  of  the  VMR  commands  in 
alphabetical  order.  Each  command  description  contains  the  following 
information : 

Command  Abbreviation 

The  minimum  number  of  letters  that  you  must  specify  when 
using  the  command  name.  The  command  abbreviation  is  located 
at  the  outside  margin  of  each  page  in  capital  letters. 

Command  Name 

The  full  command  name  in  capital  letters .  The  command  name 
is  followed  by  text  describing  the  command's  function. 

Format 

The  format (s)  you  should  use  when  specifying  the  command. 
Parameters 

The  command ' s  parameters . 

Keywords 

The  command ' s  keywords . 

Examples 

Examples  of  command  use  and  output . 

Notes 


Additional  information  about  the  command. 
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ALT 

ALTER 

Use  the  ALTER  command  to  change  the  static  priority  of  an  installed 
task . 

Format 

ALT[ER]  taskname  /PRI=priority 
Parameters 
taskname 

The  name  of  the  task  whose  priority  you  want  to  alter. 


/PRI 

The  keyword  that  changes  the  task's  static  priority, 
priority 

The  new  priority,  from  1  to  250,  you  want  to  assign  to  the 
specified  task. 

250  is  the  highest  priority  and  1  is  the  lowest  priority  you  can 
assign.  Therefore,  a  task  with  a  priority  of  200  takes 
precedence  over  a  task  with  a  priority  of  199. 

The  priority  you  enter  is  assumed  to  be  octal  unless  you  place  a 
period  (.)  after  the  priority  number. 

Example 

0MR>  ALT  TEST  /PRT>24S* 

Alters  the  static  priority  of  task  TEST  to  248 ( decimal ) . 
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ASN 


ASSIGN 

Use  the  ASSIGN  command  to  define,  delete,  or  display  logical  device 
assignments.  Logical  device  assignments  are  a  way  to  associate 
logical  names  with  physical,  pseudo,  or  logical  devices.  When  you 
assign  a  logical  name  to  a  pseudo  or  logical  device,  the  system 
resolves  the  assignment  to  the  associated  physical  device. 

There  are  several  types  of  logical-device  assignments.  VMR  supports 
the  manipulation  of  global  assignments  only.  Global  assignments  apply 
to  all  tasks  in  the  running  system. 

NOTE 

On  RSX-1 1M-PLUS  systems  with  extended  logical  name 
support,  the  VMR  ASSIGN  command  cannot  be  used  to 
manipulate  logical  names  of  any  form  other  than  linn:. 

A  logical  device  name  has  the  same  syntax  as  that  of  a  physical  device 
unit.  It  consists  of  a  2-character  ASCII  name  (alphabetic)  and  an 
optional  1-  or  2-digit  octal  unit  number,  followed  by  a  colon  (:). 
The  2-character  name  can  be  either  equivalent  to  a  standard 
RSX-1 1M/M-PLUS  device  name  (for  example,  DK:)  or  formed  by  two  letters 
picked  at  random  (for  example,  ZZ:).  If  a  logical  device  name  is 
identical  to  a  physical  device  name,  the  logical  name  is  the  one  used 
by  the  system. 

The  ASSIGN  command  has  three  formats .  These  are  described  as  follows : 

Format  1 

ASN  ppnn :=1 Inn : /keyword 

Defines  a  global  assignment  that  associates  the  logical  name  linn: 
with  the  device  ppnn:. 

Format  2 

ASN  /keyword 

Displays  all  global  assignments  for  the  system. 

Format  3 

ASN  =[ linn :] /keyword 

Deletes  the  specified  global  assignment,  or,  if  you  omit  linn:, 
deletes  all  global  assignments. 

Parameters 

PP 


A  physical,  logical,  or  pseudo  device  name. 


nn 


A  unit  number . 
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ASN  (Cont.) 

11 


A  logical  device  name. 

/keywords 

One  of  the  following: 

/GBL 

/SYSTEM 

Keywords 

/GBL 

Defines,  displays  or  deletes  global  logical  device  assignments. 
/SYSTEM 

(RSX-11M-PLUS  systems  only.)  Defines,  displays  or  deletes 
system-wide  logical  device  assignments. 

Examples 

1.  VMfO-ASN  DMJ'GBOt/GRL 

Defines  the  global  logical  device  name  GBO :  and  assigns  it 
to  DM : . 

2.  VMR > A B N  /GBL 

GB  DMO :  Global  (Terminal) 

( RSX— 1 1M— PLUS  systems  that  have  selected  support  for  extended 
logical  names.)  Lists  all  global  assignments. 

3.  VMR>ASN  “/GBL 

Deletes  all  global  assignments. 
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CAN 


CANCEL 

Use  the  CANCEL  command  to  cancel  time-based  initiation  requests  for  a 
task.  These  requests  result  from  the  RUN?  directive  or  any  of  the 
time-synchronized  variations  of  the  VMR  RUN  command. 

The  CANCEL  command  does  not  affect  the  execution  of  a  task  active  in 
the  saved  system  image.  The  CANCEL  command  removes  only  the 
time-based  schedule  requests  still  in  the  queue. 

Format 

CAN [CEL]  taskname 
Parameter 
taskname 

The  name  of  the  task  whose  time-based  initiation  requests  are  to 
be  canceled. 

Example 


V M R >  CAN  XKE 

Cancels  all  periodic  rescheduling  and  time-based  initiation 
requests  for  task  XKE. 
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CON  (Cont.) 


Single-Processor  Systems 


3. 


VM  FO¬ 
RM  A 
RHB 
RHC 
RHB 


CONFIGURATION  DISPLAY  CONTROLLERS 


OFL 

OFL. 

OFL 

OFL 


CPA 

CPA 

CPA 

CPA 


CSR*t 76700 
CBR-l 76300 
CSR-t 72040 
CSR-1 72440 


V  F.  C 22  2  5  4  PR Is 
V F C  =  1 5 0  PRI2 
0 E C : : 2 0 4  PR  I" 

V  F  C 22  2  2  4  PRI 2 


Y  HA 

Y  Z  A 
VMR> 


OFL 

OFL 


CPA 

CPA 


4.  VMR>CON  DIB  UNI 
BBOt 
DB1 1 
DB2  ♦ 

D  B  7  t 


N  LOS 
y  T  o  t 
Roo t 
y  m  r  > 


VHR>C0N 

CPA 

UMR> 


DIB  CPU 


VMR>C0N  DIB  Fin 


CBR- 

CBR: 


=  1  70500 
::  1.60  tOO 


VFC-SOO  PRI -5 
VEC=340  PR I -5 


rhao: 

OFL 

BRIOFR 

RHA1  i 

OFL 

DRIVER 

RHA2  t 

OFL 

DRIVER 

R  H  A  3  t 

OFL 

DRIVER 

OFL 

DRIVER 

OFL 

DRIVER 

ONL 

DRIVFR 

R  H  A 

OFL 

CPA 

CSR= 176700 

VEC-254 

PRI 22  5 

RHB 

OFL 

CPA 

CSR-1 76300 

VEC-t  50 

P  R 1 22  5 

RHC 

OFL 

CPA 

CSR® 172040 

V  F  C  »  2  0  4 

PRI  a 5 

RHB 

<• 

OFL 

CPA 

C  SR 1.72440 

V  E  C  :  2  2  4 

P  R  X 22  5 

* 

<■ 

BBOt 

RHAO  t 

OFL 

BRIOFR 

DBt  t 

RHA1  t 

OFL 

DRIVER 

DB2  t 

RHA2  t 

OFL 

DRIVER 

D  R  3  t 

•> 

RHA3  t 

OFL 

DRIVER 

NLO : 

OFL 

DRIVER 

y  to: 

OFL 

DRIVER 

RDO  t 
VMR> 

ONL 

DRIVER 
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7. 


V  MFD 

RHB 

RHC 

RHD 

RHH 

RHM 

RMN 

RHR 

RMS 

VMR  > 


CONFIGURATION 


OFL 

OFL 

OFL 

OFL. 

OFL 

OFL 

OFL 

OFL 


CPA 

CPA 

CPA 

CPBi 

CPC 

CPC 

CPD 

CPD 


DISPLAY 

CSR 
C  8  R 
CSR 
CSR 
CSR 
CSR  I 
CSR 
CSR- 


8. 


MHR>  CON  DIS  CPU 

CPA 

CPB 

CPC 

CPD 

MMR> 


CONTROL  LFRS 

=•*174300 
=176700 
=172440 
*176700 
=176700 
*3  72440 
=176300 
::  176700 


CON  (Cont.) 

FOR  RH 

MFC-150 

PR  I  =  5 

M  F  C  ~  2  5  4 

PR  I  «5 

MFC  -2  2  4 

PR  I -5 

MFC=?54 

PR  I  =5 

MFC -25 4 

:PRI«5 

MFC-224 

PRJ  =  5 

MFC- 150 

PR  1-5 

MFC -254 

PR  I  =5 

V  h  R  > 
CPA 
C  PS 
CPC 

CPD 


CON  DIB  FIJI 


bsot 

BSt  1 

B  S  A  0  t 
bsco  : 

BSFO  t 
BSD  01 

Cl  Ft  riRJMFR 

eSFOt  BSFO »  OFL 

DRIVER 

DBG  * 

RH  HO  t 

RHMO  J 

OFI.  PRIMER 

V 

MHR> 

10.  MCK.:- 

YHA 

YHB 

YHC 

MHR> 

CON  DIB 
OFL 
OFL 
OFL 

FOR  YH 

CPA 

CPA 

CPA 

CSR* J  60020 

CSR* 1400 40 

CSR*  1.60060 

MFC-310 

MFC-320 

MFC-330 

PR  I  *5 
PR  I  =5 
PR  I  -5 
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DEVICES 

Use  the  DEVICES  command  to  display  the  symbolic  names  of  all  device 
units  in  the  system  image  of  a  particular  device  type.  If  you  do  not 
specify  a  device  type,  VMR  displays  the  symbolic  names  of  all  device 

units . 

The  device  names  appear  in  a  single  vertical  column.  A  second  column, 
to  the  right,  contains  additional  information  about  a  device  (see 
Notes) . 

Format 

DEV[ ICES ]  [dd:] 

Parameter 

dd: 


The  device  type . 


Example 


V  M  R  > 

DEV 

LPOi 

L  o  a  d  e  d 

DBO : 

Loaded 

dm: 

L  o  a  d  e  d 

db?  : 

1.  oaded 

DDO : 

1 ...  o  a  d  e  d 

DBl  S 

1.  oaded 

DKOJ 

l.  a  a  d  e  d 

DKt : 

!..  o  a  d  e  d 

D  K  2 : 

L.  o  a  d  e  d 

B  K3S 

1.  oaded 

DL  0 : 

Loaded 

D  L  1.  t 

L  a  a  d  e  d 

dl?.: 

* .  o  a  d  e  d 

DHO : 

!.  oaded 

dhi.  : 

l.o  a  d  e  d 

dm?  : 

1.  oaded. 

DROt 

1..  oaded 

hr  i : 

L.  o  a  d  e  d 

nso: 

Of f 1 ine 

DBl  J 

0  f  f  l  i.  n  e 

D  T  o : 

Loaded 

DTt : 

!..  c.«  3  d  e  d 

dxo: 

L  o  a  d  e  d 

d  x  i : 

1.  oaded 

emo: 

i  J  n  \  o  a  •  i  e 

MHO : 

L..  o  a  ci  e  d 

i'i  M 1. : 

Loaded 

coo : 

TTO : 

t  to: 

I  o a«ied 

tti  : 

L  o  a  d  e  d 

tt?: 

L  o  s  d  e  d 

T  T3: 

L oaded 

T  T  4  : 

L  o  a  d  e  d 
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NLOi 
T  1 0  X 

CLO:  !..  POt 

i...  B  0 1  D  R  0  t 
BVOt  riROt 
V  H  R  > 

Notes 


1.  The  pseudo  device  SY:  is  not  redirected  to  the  bootstrapped 
device  until  the  system  is  bootstrapped. 


The  following  list  describes  the  types  of  messages  that  can 
appear  in  the  second  column  of  the  device  list  when  you  use 
the  DEVICES  command.  (More  than  one  message 
the  same  line.) 


loadable  and  currently  loaded. 


loadable  but  not  loaded. 

\ 

The  absence  of  either  LOADED  or  UNLOADED 
column  indicates  that  the  driver  is  permanently  resident. 
This  means  the  driver  is  part  of  the  Executive. 


can 

appear 

on 

the 

device 

is 

the 

device 

is 

in 

the  second 

•  OFFLINE  indicates,  on  RSX-11M  systems,  that  although  the 
device  list  contains  an  entry  for  the  device,  the  device 
is  not  currently  attached  to  the  system. 

•  OFFLINE  indicates,  on  RSX-11M-PLUS ,  that  a  device  has  yet 
to  be  brought  on  line  by  the  reconfiguration  task.  All 
physical  devices  in  the  device  list  have  this  notation  in 
the  second  column. 

•  A  device  name  in  the  second  column  is  the  device  to  which 
the  corresponding  device  in  the  first  column  has  been 
redirected . 
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FIX- IN-MEMORY 

Use  the  FIX  command  to  load  a  task  into  memory  and,  on  RSX-11M-PLUS 
systems,  to  load  a  region  into  its  partition  in  the  system  image,  VMR 
can  fix  a  task  in  the  system  image  only  if  the  partition  in  which  it 
is  to  be  fixed  is  available. 

Fixed  tasks  remain  in  memory  even  after  they  exit.  Therefore,  the 
system  can  run  a  fixed  task  faster  because  the  task  is  memory-resident 
and  does  not  need  to  be  reloaded.  Reexecuting  fixed  tasks  however,  is 
not  always  practical.  If  you  expect  to  reexecute  a  fixed  task,  you 
should  write  it  in  such  a  way  that  it  initializes  all  impure  data  and 
LUN  assignments  at  run  time. 

The  following  restrictions  apply  to  the  fixing  of  tasks: 

•  You  must  install  a  task  before  you  fix  it. 

•  Active  tasks  cannot  be  fixed. 

•  On  RSX-11M  systems,  you  cannot  fix  checkpointable  tasks. 

•  On  RSX-11M-PLUS  systems,  do  not  fix  a  checkpointable  task 

because  fixing  a  checkpointable  task  makes  the  task 

noncheckpointable . 

•  On  RSX-11M-PLUS  systems,  you  cannot  fix  tasks  whose  names  are 
in  the  forms  . . .xxx  and  xxx$$$  because  that  copy  of  the  task 
is  never  executed.  (The  task  is  a  prototype  task.) 

•  On  RSX-11S  systems,  all  installed  tasks  must  be  fixed  because 
they  cannot  be  loaded  into  the  running  RSX-11S  system.  If  the 
RSX-11S  system  has  memory  management  (PLAS)  support,  you 
cannot  use  the  FIX  command  to  fix  tasks .  You  must  use  the 
INSTALL  /FIX  command  instead.  See  the  description  of  the 
INSTALL  /FIX  command. 

•  On  RSX-11M  and  RSX-11S  systems,  you  can  fix  tasks  above  the 
124K-word  limit.  Before  you  fix  a  task  above  the  124K-word 
limit,  however,  you  must  first  create  another  copy  of  the 
system  image  file  larger  than  498 (decimal)  blocks.  The  system 
image  file  you  create  must  be  larger  than  498  blocks  because 
the  size  of  the  system  image  file  created  during  system 
generation  is  498  blocks  for  a  system  of  124K-words. 

Use  either  the  UNFIX  or  REMOVE  command  to  remove  a  fixed  task  from 
memory  or  remove  a  region  from  its  partition. 

Format 

FIX  taskname[ /keyword] 

Parameter 

taskname 

The  task  or  region  that  you  want  to  fix  in  memory.  If  you  do  not 

specify  a  keyword,  VMR  assumes  that  the  task  is  a  single-user 

task . 
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/keyword  (RSX-11M-PLUS  systems  only) 

One  of  the  following: 

/DIR 

/nsf 

/REG 

/RON 

Keywords 

/DIR 

Specifies  that  the  task  to  be  fixed  is  a  directive  common. 

Directive  commons  are  used  to  hold  some  of  the  Executive 

directives  instead  of  keeping  them  in  Executive  address  space. 
Because  directive  commons  contain  Executive  code,  they  must  be 

installed  and  fixed  in  the  system  image  before  the  system  can  be 

bootstrapped.  Directive  commons  are  installed  and  fixed  in  the 
system  image  by  commands  in  SYSVMR.CMD  as  part  of  the  system 
generation  procedure. 

Individual  directive  commons  are  installed  and  fixed  contiguously 
in  memory  to  form  one  large  directive  common  called  DIR11M. 
DIR11M  must  be  fixed  in  memory  before  any  other  directive  commons 
can  be  fixed.  Other  directive  commons  must  be  fixed  contiguously 
to  DIR11M. 

Directive  commons  cannot  be  shuffled,  which  means  means  that  the 
Shuffler  cannot  move  them  around  in  memory  after  they  have  been 
fixed.  For  more  information  about  the  Shuffler,  see  Chapter  14. 

To  eliminate  a  directive  common,  use  the  REMOVE  command. 

/NSF 

Specifies  that  a  fixed  task  cannot  be  shuffled.  This  means  that 
the  Shuffler  cannot  move  the  task  around  in  memory  after  the  task 
has  been  fixed.  For  information  about  the  Shuffler,  see  Chapter 
14. 

/REG 

Specifies  that  the  task  to  be  fixed  is  a  common  region. 

/RON 

Specifies  that  the  task  to  be  fixed  is  a  multiuser  task  and  that 
the  read-only  portion  is  to  be  fixed  in  memory. 

You  must  specify  the  entire  task  name. 

Examples 

1.  V M R >F I X  XKE 

Fixes  the  task  XKE  in  its  partition. 
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2.  VMR>FIX  TTCOM/RFR/NSF 

Fixes  the  resident  common  TTCOM  in  its  partition, 
specifies  that  the  task  cannot  be  shuffled. 

3.  V  H  R  >  F I X  .  FM  /RON 

Indicates  that  the  EDI  editor  is  built  as  a  multiuser 
and  fixes  the  task's  read-only  portion  in  memory. 


and 


task 
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INSTALL 

Use  the  INSTALL  command  to  make  a  task  or  common  recognizable  to  the 
system.  On  RSX-11M  and  RSX-11S  systems,  you  can  also  use  the  INSTALL 
command  to  load  a  common  into  a  common  partition.  See  the  description 
of  the  FIX  command  for  more  information.  You  can  install  commons 
above  the  124K-word  limit.  You  cannot  run  a  task  until  you  install 

Once  a  task  is  installed,  VMR  creates  a  Task  Control  Block  (TCB)  for 
the  task  in  a  system  image  table  called  the  System  Task  Directory 
(STD).  The  task  parameters  contained  in  the  TCB  enable  the  system  to 
run  the  task  when  requested  to  do  so  by  an  MCR  command,  VMR  command, 
or  a  system  directive. 

Format 

INS [TALL]  filespec[ /keyword ( s ) ] 

Parameters 
f ilespec 

A  task  image  file  specification  in  the  form: 

LB : [g ,m] filename . type; version 

The  task  image  file  you  specify  must  be  on  the  device  LB:.  The 
file  type  defaults  to  .TSK. 

/keyword ( s ) 

Any  keyword  you  specify  either  provides  parameters  that  were  not 
specified  at  task-build  time  or  overrides  parameters  that  were 
specified  at  task -build  time. 

One  or  more  of  the  following: 

/AFF=[ urm] 

/CKP=option 

/ CLI=option 

/FIX=option 

/FMAP=option 

/ INC=size 

/lOP=option 

/PAR=pname 

/PMD=option 

/PRI=number 

/ PRO=[ system , owner , group , world ] 

/RON=option 
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/ROPAR=pname 

/SEC=option 

/SLV=option 

/ SYNC=option 

/TASK=taskname 

/UIC=[group/member] 

/WB=option 

/XHR=option 

Keywords 

/  AFF=[URM ( s ) ] 

( RSX-1 1M-PLUS  multiprocessor  systems  only.)  The  UNIBUS  Run  Mask 
(URM)  affinity  of  the  task.  You  must  specify  at  least  one  URM. 
Enclose  the  URM(s)  in  square  brackets  ([  ]). 

If  you  specify  more  than  one  URM,  you  must  separate  them  by 
commas .  For  example : 

/AFF= [UBE , UBF , UBH] 

When  you  specify  the  /AFF  keyword,  the  installed  task  runs  only 
on  the  processor  to  which  the  specified  URMs  are  connected. 

UNIBUS -run-mask 

The  three- letter  name  of  the  URM  for  the  CPU  or  switched 
UNIBUS  run.  The  following  names  are  valid  URM 
specifications : 


CPA 

UBE 

UBK 

UBP 

CPB 

UBF 

UBL 

UBR 

CPC 

UBH 

UBM 

UBS 

CPD 

UBJ 

UBN 

UBT 

/ CKP=option 

(For  systems  that  support  dynamic  allocation  of  checkpoint 
space.)  Enables  or  disables  checkpointing  for  a  task. 

The  options  are  YES  and  NO.  If  /CKP=YES,  checkpointing  is 
enabled  for  the  task.  If  /CKP=NO,  checkpointing  is  disabled  for 
the  task. 

The  task  image  file  need  not  contain  allocated  checkpoint  space. 
The  /CKP=YES  keyword  instructs  the  system  to  allocate  checkpoint 
space  for  the  task,  when  required,  from  a  checkpoint  file. 

On  RSX-1 1M  systems,  if  a  task  was  built  with  the  /XH  switch,  the 
/ CKP  keyword  is  disabled  for  that  task. 
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The  / CKP  keyword  overrides  the  /CP  switch  specified  at  task-build 
time . 

The  default  is  /CKP=YES. 

/CLI=option 

Indicates  that  the  task  being  installed  is  or  is  not  a  command 
line  interpreter  (CLI). 

The  options  are  YES  and  NO.  /CLI=YES  indicates  that  the  task  is 
a  command  line  interpreter.  /CLI=NO  indicates  that  the  task  is 
not  a  command  line  interpreter. 

You  must  indicate  that  a  task  is  a  CLI ,  either  by  installing  it 
with  the  / CLI=YES  keyword,  or  by  taskbuilding  it  with  the  /CL 
switch,  before  you  can  set  a  terminal  to  that  CLI  or  work  with 
the  CLI  by  means  of  the  MCR  CLI  command.  See  the  RSX-11M/M-PLUS 
and  Micro/RSX  Task  Builder  Manual  for  more  information  on  the 
Task  Builder  /CL  switch. 

The  default  is  whatever  was  specified  at  task-build  time. 
/FIX=option 

( RSX-11S  systems  only.)  Indicates  whether  tasks  on  RSX-11S 
systems  with  memory  management  (PLAS)  support  will  be  fixed  in 
memory. 

The  options  are  YES  and  NO.  When  you  specify  /FIX=YES,  the  task 
is  installed  and  fixed  in  memory. 

On  RSX-11S  systems  with  memory  management  support  (PLAS),  VMR 
requires  that  you  fix  all  tasks  by  using  /FIX=YES.  You  cannot 
install  the  task  and  fix  it  later  with  the  FIX  command. 

The  default  is  /FIX=NO 

/FMAP=option 

( RSX-1 1M-PLUS  systems  only.)  Informs  the  system  that  the  task 
will  use  the  fast-mapping  feature  of  the  Executive.  You  can  i*se 
the  /FMAP  keyword  only  with  tasks  that  have  external  headers. 

The  options  are  YES  and  NO.  /FMAP=YES  indicates  the  task  will 
use  the  fast-mapping  feature  of  the  Executive.  /FMAP=NO 
indicates  the  task  will  not  use  the  fast-mapping  feature  of  the 
Executive . 

See  the  description  of  the  /XHR  keyword  for  more  information 
about  external  headers  and  the  RSX-11M/M-PLUS  and  Micro/RSX 
Executive  Reference  Manual  for  more  information  about  fast 
mapping. 

The  default  is  whatever  was  specified  at  task-build  time. 
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/ INC=size 

(Mapped  systems  only.)  Indicates  the  extension  size  of  a  task. 
The  extension  size  refers  to  the  number  of  additional  words  of 
address  space  you  want  allocated  to  a  task  running  in  a 
system-controlled  partition.  The  extension  size  is  usually 
expressed  in  octal  but  may  also  be  expressed  in  decimal  by 
following  the  size  with  a  period  ( . ) . 

Tasks  such  as  MAC,  TKB ,  PIP,  VFY ,  and  AT.  (Indirect)  use  the 
space  from  the  end  of  the  task  image  to  the  end  of  their  address 
space,  as  dynamic  memory  in  which  to  allocate  symbol  tables  and 
buffers.  The  /INC  keyword  defines  the  number  of  words  in  this 
dynamic  region.  The  /INC  keyword  overrides  the  Task  Builder's 
EXTTSK  or  PAR  options . 

If  a  common  is  installed  with  an  increment,  it  will  no  longer  fit 
in  its  original  task  image  file.  Therefore,  you  cannot  specify 
both  / INC=size  and  /WB=YES  when  installing  a  common. 

The  default  size  is  the  size  specified  at  task-build  time  or  zero 

(0). 

/lOP=option 

Informs  the  system  that  a  privileged  task  needs  access  to  the  I/O 
page . 

The  options  are  YES  and  NO.  If  /lOP=YES,  INSTALL  assumes  that 
the  task  will  use  the  I/O  page  and,  if  the  task  is  larger  than 
8K-words,  issues  a  warning  message  because  the  I/O  page  will  not 
be  mapped.  If  /lOP=NO,  INSTALL  assumes  that  the  task  does  not 
need  to  use  the  I/O  page.  No  warning  message  is  issued. 

The  default  is  whatever  was  specified  at  task-build  time. 

/PAR=pname 

Indicates  a  partition  that  overrides  the  partition  name  specified 
at  task-build  time.  If  the  partition  you  specify  does  not  exist, 
VMR  issues  a  warning  message  and  attempts  to  install  the  task  in 
the  GEN  partition. 

On  RSX-11M  systems,  if  the  task  you  install  is  built  with 
checkpoint  space  allocated  in  the  task  image  file,  and  you 
specify  a  user-controlled  partition  with  the  /PAR  keyword,  the 
task's  allocated  checkpoint  space  may  no  longer  be  large  enough 
to  hold  the  task.  The  reason  for  this  is  that  when  you  specify  a 
user-controlled  partition,  the  size  of  the  task  is  automatically 
extended  to  the  size  of  the  partition.  If  the  user-controlled 
partition  specified  when  the  task  is  installed  is  larger  than  the 
task  size  specified  when  the  task  was  built,  the  task  will  no 
longer  fit  in  its  allocated  checkpoint  space. 

The  default  is  whatever  was  specified  at  task -build  time. 
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/PMD=option 

Informs  the  system  whether  a  Postmortem  Dump  is  required. 

The  options  are  YES  and  NO.  If  /PMD=YES,  the  system  performs  a 
Postmortem  Dump  of  the  task  when  the  task  is  aborted  because  of 
an  SST  error  condition.  If  /PMD=NO,  the  system  does  not  perform 
a  Postmortem  Dump  when  the  task  is  aborted . 

To  generate  a  Postmortem  Dump,  you  must  install  the  Postmortem 
Dump  task  PMD. . .  in  the  system.  /PMD  overrides  the  Task 
Builder's  /PM  switch. 

The  default  is  whatever  was  specified  at  task-build  time. 
/PRI=number 

Indicates  the  priority,  from  1  to  250,  you  want  assigned  to  the 
installed  task. 


250  is  the  highest  priority  and  1  is  the  lowest  priority  you  can 
assign.  Therefore,  a  task  with  a  priority  of  200  takes 
precedence  over  a  task  with  a  priority  of  199. 


The  priority  you  enter  is  assumed  to  be  octal  unless  you  place  a 
period  (.)  after  the  priority  number. 

The  default  is  PRI=50 ( decimal ) . 


/ PR0=[ system , owner , group , world ] 

( RSX-11M-PLUS  systems  only. )  Sets  the  protection  mask  for  a 
common.  You  must  use  square  brackets  ([  ]). 

When  you  specify  a  protection  mask  for  a  common  with  the  /PRO 
keyword,  you  replace  the  user  groups  (system,  owner,  group, 
world)  with  access  types  (read  (R),  write  (W) ,  extend  (E),  delete 
(D) )  to  indicate  the  type  of  access  you  want  assigned  to  each 
user  group.  To  assign  an  access  type  to  a  particular  user  group, 
you  place  the  access  type  or  types  in  the  same  position  as  the 
group  name.  User  groups  are  delimited  by  commas.  For  example: 

/PR0= [ RWED , RWED , ED , R] 

The  access  types  are  described  as  follows: 

Read  Access  (R) 

Allows  a  task  to  read  from  a  common. 

Write  Access  (W) 

Allows  a  task  to  write  to  a  common. 

Extend  Access  (E) 

Allows  a  task  to  extend  the  region  in  a  common. 

Delete  Access  (D) 

Allows  a  task  to  delete  a  common. 
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The  user  groups  are  defined  as  follows: 

System 

All  system  tasks  running  under  a  UIC  group  number  less 
than  or  equal  to  10 (octal). 

Owner 

Tasks  that  run  under  the  same  UIC  as  the  file's  owner. 

Group 

Any  task  that  is  running  under  the  same  UIC  group  as 
the  file's  owner. 

World 

Any  task  that  does  not  fit  in  one  of  the  above 
categories . 

You  assign  a  group  unlimited  access  by  specifying  RWED  in  the 
group's  position.  You  assign  a  group  no  access  by  inserting  a 
comma  in  the  group's  position.  For  example: 

/PRO=[ RWED, RWED, , RWED] 

Here,  a  task  running  under  the  same  UIC  group  as  the  file's  owner 
has  no  access . 

You  cannot  specify  protection  options  for  a  read-only  common 
region  or  the  read-only  portion  of  a  multiuser  task.  A  task 
linked  to  a  common  region  with  an  improper  protection  mask  cannot 
be  installed. 

The  default  is  / PR0=[ RWED, RWED, RWED, RWED] . 

/R0N=option 

( RSX-1 1M-PLUS  systems  only.)  Informs  the  system  that  a  common 
region  is  or  is  not  read-only. 

The  options  are  YES  and  NO.  If  /RON=YES,  the  region  is  installed 
as  read-only.  If  /R0N=N0,  the  region  is  installed  with 
read/write  access . 

The  /RON  keyword  overrides  the  effect  of  the  /PRO  keyword. 

The  default  is  /RON=NO. 

/ROPAR=pname 

( RSX-1 1M-PLUS  systems  only.)  Indicates  the  read-only  partition 
(pname)  into  which  the  read-only  portion  of  a  multiuser  task  is 
to  be  installed. 

If  the  partition  you  specify  does  not  exist,  VMR  issues  a  warning 
message  and  attempts  to  install  the  read-only  portion  of  the  task 
into  the  partition  containing  the  read/write  portion  of  the  task. 
The  /ROPAR  keyword  overrides  the  Task  Builder  options. 

The  default  is  whatever  was  specified  at  task -build  time. 
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/ SEC=option 

(RSX-11M-PLUS  systems  only.)  Places  the  Task  Control  Block  ( TCB ) 
for  the  task  being  installed  in  secondary  pool. 

The  options  are  YES  and  NO.  If  /SEC=NO,  the  TCB  for  the  task  is 
placed  in  primary  pool  instead  of  secondary  pool.  The  /SEC 
keyword  is  valid  only  for  tasks  whose  names  are  in  the  form 
. . .xxx  or  xxx$$$ . 

The  default  is  /SEC=YES . 

/SLV=option 

Informs  the  system  of  the  task's  slave  status. 

The  options  are  YES  and  NO.  If  /SLV=YES,  data  sent  to  the 
installed  task  is  marked  with  the  TI :  of  the  sending  task.  When 
the  installed  task  receives  the  data,  the  system  sets  the  task's 
TI:  to  that  associated  with  the  data.  The  /SLV=YES  keyword 

overrides  the  Task  Builder's  /SL  switch.  If  you  specify  /SLV=NO, 
the  TI :  of  the  task  does  not  change  when  the  task  receives  data. 

On  RSX-11M-PLUS ,  the  /SLV  keyword  cannot  be  used  with  tasks  whose 
names  are  in  the  form  ...xxx.  These  tasks  are  prototype  tasks 
and  cannot  be  installed  as  slaved  tasks. 

The  default  is  whatever  was  specified  at  task-build  time. 

/SYNC=option 

( RSX-1 1M-PLUS  multiprocessor  systems  only.)  Synchronizes  task  use 
of  a  common,  permitting  several  tasks  to  share  a  common  and  use 
the  common  for  synchronization.  For  example,  if  two  tasks  access 
the  same  common,  the  /SYNC  keyword  ensures  that  only  one  of  the 
tasks  executes  at  one  time.  This  prevents  the  second  task  from 
reading  from  or  writing  to  the  common  while  the  first  task  is 
executing . 

The  options  are  YES  and  NO.  You  can  specify  /SYNC=YES  for  two  or 
more  tasks,  but  only  one  of  the  tasks  can  execute  at  one  time. 
If  one  of  the  tasks  becomes  blocked,  the  others  compete  to 
execute . 

The  default  is  /SYNC=NO. 

/TASK=taskname 

Specifies  the  name  you  want  to  give  the  task. 

The  default  is  the  name  specified  at  task-build  time  or  the  first 
six  characters  of  the  file  name.  See  the  RSX-11M  System 
Generation  and  Installation  Guide  or  the  RSX-11M-PLUS  System 
Generation  and  Installation  Guide  for  an  explanation  of  multiuser 
system  defaults. 
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/UIC=[ group .member] 

Specifies  the  UIC  for  the  task.  The  task's  UIC  determines  the 
file-protection  class  (system,  owner,  group,  world)  to  which  a 
task  belongs.  You  must  use  square  brackets  ([  ]). 

You  can  use  the  /UIC  keyword  only  when  installing  tasks  started 
by  a  RUN?  directive  or  started  by  a  RUN  command  that  specifies  a 
time  delay.  You  can  override  the  UIC  with  the  RUN  command. 
Tasks  installed  wjlth  names  of  the  form  .  .  xxx  and  tasks  started  by 
the  RUN  command  without  a  time  delay  run  under  the  protection  UIC 
of  the  terminal  from  which  the  command  was  issued. 

The  default  is  the  UIC  specified  at  task-build  time. 

/WB=option 

( RSX-1 1M-PLUS  systems  only.)  Specifies  where  a  read/write  common 
will  be  checkpointed  to.  By  default,  a  common  is  checkpointed  to 
a  system  checkpoint  file. 

The  options  are  YES  and  NO.  If  /WB=YES,  the  common  is 
checkpointed  to  its  original  task  image  file.  When  the  common  is 
removed,  it  is  written  back  to. its  original  task  image  file.  If 
/WB=NO,  the  common  is  checkpointed  to  a  system  checkpoint  file. 
The  common  is  not  written  back  when  removed. 

If  a  common  is  read-only,  there  is  no  need  to  checkpoint  it. 
Therefore,  the  /WB  switch  is  ignored  when  a  common  is  installed 
with  /RON=YES. 

If  a  common  is  installed  with  an  increment,  it  will  no  longer  fit 
in  its  original  task  image  file.  Therefore,  you  cannot  specify 
both  /lNC=size  and  /WB=YES  when  installing  a  common. 

The  default  is  /WB=NO. 

/XHR=option 

( RSX-1 1M-PLUS  systems  only.)  Specifies  that  the  Executive's  copy 
of  the  task's  header  will  be  in  an  area  external  to  the  system's 
dynamic  storage  region  (pool). 

The  options  are  YES  and  NO.  If  /XHR=YES ,  the  task  is  installed 
with  an  external  header.  If  /XHR=NO,  the  task  is  installed  with 
a  resident  header. 

When  you  specify  /XHR=YES,  the  task's  header  is  not  kept  in  pool. 
Instead,  a  copy  of  the  header  is  placed  in  a  reserved  area 
immediately  below  the  task  image.  The  Executive  uses  the  copy  of 
the  header  rather  than  the  actual  header.  When  the  task  is 
checkpointed,  the  system  writes  the  task  image  and  the  copy  of 
the  header  into  the  checkpoint  file.  The  header  in  the  task 
image  is  left  unchanged. 

The  /XHR  keyword  correlates  with  the  /XH  option  for  the  Task 
Builder.  The  default  for  /XHR  and  the  ability  for  a  user  to 
override  the  option  specified  at  task-build  time  depend  on  how 
the  INSTALL  task  was  built  during  system  generation. 
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You  can  change  the  effect  of  the  /XHR  keyword  by  selecting  one  of 
several  options.  The  options  determine  the  default  action  the 
system  takes  when  a  task  is  installed.  To  select  an  option,  your 
system  manager  must  modify  INSBLD.CMD,  the  build  command  file  for 
the  INSTALL  task. 

INSBLD.CMD  must  include  the  following  command  line: 

GBLPAT  =  INSROT : $HDDEF : / n 

where  n  is  the  number  of  the  desired  option.  The  default  option 
is  1 . 

After  the  command  file  has  been  modified,  the  INSTALL  task  must 
be  rebuilt  and  then  reinstalled  in  the  system  with  VMR. 

You  can  select  one  of  the  following  options: 


1.  By  default,  every  task  is  installed  with  an  external  header. 
You  can  override  this  option  by  specifying  /XHR=NO.  This 
option  is  provided  for  users  who  want  their  system  always  to 
install  tasks  with  external  headers.  The  option  also 
prevents  users  from  unnecessarily  or  accidentally  using 
headers  in  pool . 

For  existing  RSX-11M-PLUS  sites,  selecting  this  option  allows 
the  use  of  external  headers  without  having  to  rebuild  the 
nonprivileged  application  system. 

2.  By  default,  the  headers  for  privileged  tasks  are  in  pool  and 
the  headers  for  nonprivileged  tasks  are  external.  This 
option  can  be  overridden  when  a  task  is  built  or  installed. 
This  option  is  provided  for  users  who  have  user-written 
privileged  code  that  needs  to  be  converted  before  it  can 
execute  with  an  external  header.  The  application  system  does 
not  have  to  be  rebuilt  to  use  external  headers. 

3.  By  default,  the  headers  for  all  tasks  are  in  pool.  You  can 
override  this  option  when  the  task  is  built  (/XH)  or  when  the 
task  is  installed  (/XHR=YES).  This  option  is  provided  for 
users  who  have  user-written  ACPs  or  privileged  code  that 
examines  the  header  of  another  task. 

If  you  select  this  option,  you  must  either  rebuild  or  install 
a  task  with  an  external  header  (TKB  /XH  or  INS  /XHR=YES ) 
before  it  can  execute  with  an  external  header.  Because  any 
user  can  specify  the  /XH  switch,  this  option  is  recommended 
for  friendly  environments.  (Only  privileged  users  can 
specify  the  /XHR  keyword.) 

4.  By  default,  the  headers  for  all  tasks  are  in  pool.  The 
option  can  be  overridden  by  a  privileged  user  by  specifying 
/XHR=YES  when  the  task  is  installed. 

This  option  is  similar  to  option  3,  but  it  cannot  be 
overridden  by  the  Task  Builder's  /XH  switch.  The  option 
gives  the  system  manager  more  control  over  the  environment 
and  must  be  selected  for  those  systems  that  cannot  allow  any 
code,  including  nonprivileged  code,  to  execute  with  external 
headers . 
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5.  By  default,  the  headers  for  all  tasks  are  ir  pool.  This 
option  cannot  be  overridden.  Selecting  this  option  is  not 
recommended.  The  effect  of  the  option  is  similar  to  choosing 
a  nonstandard  Executive  during  system  generation,  so  that 
support  for  external  headers  is  not  included.  This  option 
must  be  selected,  however,  for  those  systems  that  cannot 
allow  any  code,  including  nonprivileged  code,  to  execute  with 
external  headers . 

Note  that  the  options  do  not  apply  to  tasks  that  were  built  with 
the  /-XH  switch  specified.  The  headers  for  these  tasks  are 
always  in  pool  when  the  tasks  are  installed,  regardless  of  the 
option  selected,  because  the  /XHR  keyword  cannot  override  the 
/-XH  switch. 

Examples 


1.  UMR>  INSTALL  SCAN 

Installs  task  SCAN  using  the  default  priority  and  directory. 

2.  VMRMNS  8CAN/CI.I  =YFS 

Informs  the  system  that  the  task  SCAN  is  a  CLI . 

3 .  V M R > 1 U ft  S n A N / F IX* YES 

Requests  the  system  to  install  SCAN  and  fix  SCAN  in  memory. 


4 .  V K R > I M S  S C A N / F M A P * YFS 

Informs  the  system  that  the  task  SCAN  will  use  the 
fast-mapping  feature  of  the  Executive. 


5. 

Utfft> INS 

-SCAN/ 1  OP*  YES 

Informs 

access 

the  system  that  the  privileged 
to  the  I/O  page. 

task. 

SCAN, 

needs 

6. 

UMRMNS 

MAC./ INC  =  4096 .  /PAR--SY8CTL 

Installs  task  MAC  in  the  partition  SYSCTL 
task  size  by  4096 (decimal ) -words . 

and 

increases  the 

7. 

VMR>TNS 

TALI.  DM1. :  Cl ,  1. 1 1  IS  CAN  .  TSK  i  4/F’RT.  =  1.03 

Installs  task  SCAN /  file  type  .TSK,  version  4, 
DM1 : ,  group  number  1,  member  number  111,  with 
103 (octal ) . 

from  device 
a  priority  of 

8. 

SCAN/PRO*  C i RUED » » ? 1 

Requests  the  system  to  install  the  task  SCAN  with  a 
protection  mask  that  permits  tasks  running  under  the  same  UIC 
as  the  file's  owner  to  have  Read,  Write,  Extend,  and  Delete 
access.  Tasks  with  other  UIC's  are  denied  access. 
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9  .  y h R > I N S  8 C A N / S Y M C ~  YE S 

Informs  the  system  that  other  tasks  can  share  a  common  with 
the  task  SCAN  but  that  only  one  of  the  tasks  may  execute  at 
one  time . 

10.  V H R > IN 8  B 0 0 / U R  =  Y F S 

Specifies  that  the  read/write  common  BOO  will  be  checkpointed 
to  its  original  task  image  file. 

Notes 


1.  On  RSX-11M  systems,  changes  made  in  a  common  are  made  only  in 
the  memory  image  of  the  common.  Therefore  a  common  does  not 
retain  changes  when  it  is  removed  and  then  reinstalled. 


2.  On  RSX-11M-PLUS  systems,  changes  made  in  the  memory  image  of 
a  common  can  be  preserved  when  the  common  is  removed  by 
installing  the  common  with  the  /WB=YES  option. 

If  the  common  has  been  installed  with  the  /WB=YES  option,  the 
REMOVE  command  writes  the  common,  with  its  changes,  into  its 
original  task  image  file  replacing  the  original  image.  When 
the  common  is  reinstalled,  the  new  version  of  the  common  (as 
it  existed  in  memory  when  it  was  removed)  is  placed  in 
memory . 

3.  On  RSX-11M-PLUS  systems,  you  cannot  use  the  INSTALL  command 
to  install  device  commons  that  have  been  created  with  the  SET 
/PAR  command.  (A  device  common  is  a  special  type  of  common 
that  occupies  physical  addresses  in  the  I/O  page.) 

When  you  use  the  SET  command  to  create  a  device  partition, 
the  following  operations  occur: 

1.  If  the  device  partition  being  created  is  the  first  device 
partition  in  the  system,  the  system  automatically  creates 
a  main  partition  called  10  PAR.  The  partition  being 
created  then  becomes  a  subpartition  of  10  PAR. 

2.  The  system  creates  an  entry  for  the  new  device  partition 
in  the  Common  Block  Directory  (CBD)  and  inserts  the 
partition  into  the  directory.  The  device  partition  is 
now  a  device  common. 

Because  the  system  creates  a  common  block  for  the  device 
partition  automatically,  there  is  no  need  to  install  it  as  a 
common.  Attempting  to  do  so  results  in  an  error  message. 

4.  When  VMR  installs  a  task  in  an  unsaved  system,  it  stores  the 
task's  Logical  Block  Number  (LBN)  in  the  Task  Control  Block 
(TCB).  When  you  save  a  system,  the  SAVE  command  places  the 
file  identification,  rather  than  the  file's  LBN,  in  the  TCB. 
When  the  system  is  rebooted,  it  opens  the  task  file  and 
stores  the  task's  new  LBN  in  its  TCB.  If  a  task  has  been 
deleted,  the  system  cannot  open  the  task  file  when  the  system 
is  rebootstrapped.  The  system  then  automatically  removes  the 
task's  TCB  from  the  System  Task  Directory  (STD). 
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When  VMR  installs  a  task  in  a  saved  system  image,  it  stores 
the  task's  file  identification,  rather  than  the  LBN,  in  the 
TCB  to  allow  a  rebootstrap  to  occur  successfully.  It  is 
important  that  a  saved  system  image  not  retain  the  physical 
disk  addresses  of  the  installed  tasks  because  the  Disk  Save 
and  Compress  Utility  Program  (DSC)  or  the  Backup  and  Restore 
Utility  (BRU)  can  compress  and  copy  a  disk  containing  a  saved 
system,  thus  moving  the  task  files  to  different  physical 
locations .  Because  the  TCB  entries  contain  task  file 
identifications  rather  than  LBNs,  the  system  can  function 
normally  when  it  is  rebootstrapped. 
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LOAD 

Use  the  LOAD  command  to  load  a  nonresident  device  driver  into  the 
system  image.  LOAD  either  links  a  driver  to  an  already  resident  data 
base  or  loads  a  loadable  data  base  with  the  driver.  This  command 
eliminates  the  need  to  link  infrequently  used  device  drivers 
permanently  into  the  Executive . 

Executive  support  of  loadable  device  drivers  is  a  system  generation 
option  on  RSX-11M  but  is  always  included  on  RSX-11M-PLUS . 

Format 

LOA[D]  dd : [/keyword ( s) ] 


A  2-character  ASCII  device  name, 
/keyword ( s ) 

One  or  two  of  the  following: 
/CTB=cc[a,b, . . .] 

/ PAR=pname 
/ SIZE=psize 
/VEC 


Keywords 
/CTB=cc[a,b, . . . ] 

( RSX-11M-PLUS  systems  only.)  The  cc  value  is  the  name  of  the 
multidriver  controller  (CTB)  that  should  be  used  instead  of 
$ddCTB  in  the  loadable  data  base. 

[a,b,...]  are  slots  in  the  CTB ' s  KRB  table  that  should  point  at 
the  KRBs  in  the  loadable  data  base. 

The  slots  are  named  A, B, C, D, E, F, H, J, K, L,M, N, P, R, S,  and  T. 

The  /CTB  keyword  is  used  to  load  a  driver  that  references  a  split 
data  base.  Refer  to  the  RSX-11M-PLUS  Guide  to  Writing  an  I/O 
Driver  for  more  information. 

/ PAR=pname 

The  partition  into  which  the  driver  is  to  be  loaded.  The  pname 
value  is  name  of  the  partition. 

The  /PAR  keyword  overrides  the  partition  specified  at  task -build 
time . 
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/SIZE=psize 

The  minimum  size  of  the  partition  (psize)  in  octal-words  into 
which  the  driver  is  to  be  loaded. 

VMR  rounds  the  partition  size  up  to  the  next  largest  unit  of 
100 ( octal ) .  The  partition  size  must  be  less  then  77741 (octal) . 

/VEC 

(RSX-11M-PLUS  systems  only.)  Informs  the  system  that  the  driver 
to  be  loaded  is  a  vectored  driver.  This  prevents  the  normal 
comparison  of  the  driver  symbol  table  file  and  the  system  symbol 
table  file. 

Examples 

1.  VMR>L0A  MM: 

Loads  the  TU16  driver  (MMDRV ) . 

2  .  OMFOL 0A  DK : /PAR  =  DRVPAR 

Loads  the  RK05  driver  ( DKDRV )  into  DRVPAR . 

3.  VMR>L0A  0R*:/CTB  =  RHB 

Loads  the  RM03  driver  ( DRDRV ) ,  using  the  RHB  multidriver 
controller . 


Notes 

1.  On  RSX-11M  systems ,  you  can  LOAD  drivers  above  the  124K-word 
limit.  See  the  description  of  the  FIX  command  for  more 
information . 

2.  Guidelines  for  building  user-written,  loadable  device-driver 
tasks  are  defined  in  the  RSX-11M  Guide  to  Writing  an  I/O 
Driver  and  the  RSX-11M-PLUS  Guide  to  Writing  an  I/O  Driver. 

3.  The  LOAD  command  requires  that  a  driver's  .TSK  and  .STB  files 
reside  in  the  same  directory  and  on  the  same  disk  as  the 
system  image  file  you  are  working  on.  For  example,  the 
command : 

LOAD  DT: 

requires  that  the  files  DTDRV.TSK  and  DTDRV . STB  reside  on  the 
device  SY:,  under  the  current  UIC. 

4.  The  LOAD  command  requires  the  following  pool  space: 

•  If  the  driver  data  base  is  being  loaded,  the  data  base 
needs  contiguous  pool  space  equal  to  its  size. 

•  In  a  mapped  system,  each  interrupt  entry  in  the  driver 
needs  pool  space  for  an  Interrupt  Control  Block  (ICB) . 

•  If  the  driver  is  being  loaded  into  a  system-controlled 
partition,  the  Partition  Control  Block  (PCB)  needs  pool 
space . 
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LOGICAL  UNIT  NUMBERS 

Use  the  LUN  command  to  display  the  static  LUN  assignments  for  a 
specified  task.  Static  assignments  are  those  recorded  in  the  task's 
disk  image  file,  for  example,  those  assignments  specified  at 
task-build  time.  The  display  consists  of  a  list  of  physical  device 
units  in  one  column  and  their  corresponding  LUNs  in  an  adjoining 
column. 

Format 

LUN[S]  taskname 
Parameter 
taskname 

The  name  of  the  task  whose  LUNs  you  want  to  display. 

Example 


VMR>L UN  XKE 

syo:  1 
syo:  2 
clo:  3 
T  T  3  ♦  4 

TT3  ♦  5 

dkg:  6 

TT3J  7 


The  display  shows  static  assignments  for  LUNs  1  through  7  as 
recorded  in  the  task  image  file  header.  No  other  LUNs  are 
assigned  statically  to  the  task  XKE. 
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Use  the  PARTITION  command  to  display  a  description  of  each  memory 
partition  in  the  system  image. 

The  partition  display  consists  of  columns  that  specify  the  following: 

•  Partition  name 

•  Partition  Control  Block  address  (in  octal) 

•  Partition  base  address  (in  octal) 

•  Partition  size  (in  octal) 

•  Partition  type 

•  Name  of  partition  occupant (s) 

On  RSX-1 1M-PLUS ,  the  symbols  accompanying  the  partition  name  have  the 
following  meanings: 

<  >  active  task 

[  ]  in  memory  but  inactive 

+  +  multiuser  task  (read-only  section) 

l  i  read-write  named  common 

(  )  driver 

Format 

PARTITIONS] 


Example 


The  following  example 


Name  PCB  Base 


VMR>PAR 
SYSPAR  035720 
SPLPAR  035654 
DRV PAR  035610 
035324 
035260 
03521.4 
035150 
0351.04 
034774 
034730 
034664 
034620 
034534 
034470 
034424 
034360 
034314 
035040 


00200300 

00210300 

00223300 

00223300 

00227000 

00230300 

00234100 

00235700 

00246400 

00247700 

00251500 

00252700 

00310400 

00330400 

00332000 

00333300 

00336400 

00336500 


is  from  a  saved  system: 


Size 


Type  Description 


00010000 
00013000 
00140000 
00003500 
00001300 
00003600 
00001600 
00004200 
00001300 
00001600 
00001  2.00 
00035500 
00020000 
00001.400 
00001300 
00003100 
00000100 
00004400 


MAIN 

MAIN 

MAIN 

DRIVER 

<DB 

J  ) 

DRIVFR 

(DK 

J  ) 

DRIVER 

(DR 

: ) 

DRIVFR 

(DS 

: ) 

DRIVER 

(DM 

: ) 

DRIVER 

(DT 

:  > 

DRIVER 

(DX 

:  > 

DRIVFR 

UP 

:  > 

RU  COM 

ITTC0M 

DRIVFR 

(TT 

: ) 

DRIVER 

(RD 

:  > 

DRIVFR 

(VT 

: ) 

DRIVER 

(CO 

: ) 

DRIVFR 

(NL 

: ) 

DRIVER 

(MM 

: ) 
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TSTPAR 

SEC POL 

GEN 

UMR> 


PAR  (Cont.) 


035544  00363300  00003000 
033774  00363300  00003000 
035500  00366300  00040000 
036454  00366300  00040000 
035434  00426300  00050000 
035370  00476300  04701.500 


MAIN 

TASK  <L0R  ♦  . »  > 
MAIN 

TASK  CSAOTO  > 
SEC  POOL 


MAIN 
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REASSIGN 

Use  the  REASSIGN  command  to  reassign  a  task's  logical  unit  numbers 
(LUNs)  from  one  physical  device  unit  to  another.  REASSIGN  has  no 
effect  on  the  assignments  for  a  task  that  is  fixed  or  loaded  in 
memory.  The  reassignments  affect  only  the  static  assignments  recorded 
in  the  task's  disk  image  file. 

Format 

REA[SSIGN]  taskname  LUN  new: 

Parameters 

taskname 

The  name  of  the  task  for  which  the  LUN  is  to  be  reassigned. 


LUN 


The  logical  unit  number. 

new: 

The  new  device  unit,  which  can  be  a  physical,  logical,  or  pseudo 
device . 

Examples 

1.  VMR>REA  LOAN  3  TTOt 

Reassigns  LUN  3  of  task  LODN  to  physical  device  TTO : . 

2.  V M R > REA  TEST  3  XX : 

Reassigns  LUN  3  of  task  TEST  to  logical  device  XX:. 
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REDIRECT 

Use  the  REDIRECT  command  to  redirect  all  I/O  requests  from  one 
physical  device  unit  to  another  physical  device  unit. 

You  cannot  redirect  the  following: 


•  The  pseudo  device  TI : 

•  A  device  to  the  pseudo  device  TI : 

•  A  pseudo  device  to  itself 

•  An  attached  device 

•  A  terminal  to  the  null  device. 

You  can  redirect  a  logged-in  terminal  to  a  device  other  than  a 
terminal  (except  for  the  null  device);  however,  it  is  not  generally 
advisable  to  do  so  because  terminal  I/O  would  be  written  to  the 
device,  which  could  destroy  the  boot  block.  If  you  do  redirect  a 
terminal  to  another  type  of  device,  you  should  redirect  the  terminal 
back  to  itself  before  you  log  out. 

Format 

REDCIRECT]  new:=old: 

Parameters 

new: 


The  new  device  unit  to  which  requests  will  be  redirected. 

old: 

The  old  device  unit  from  which  requests  will  be  redirected. 
Examples 

1.  VMR>RED  TT3:=TTA: 

Redirects  all  I/O  requests  for  device  TT6 :  to  device  TT3 : . 

2.  vmr > red  tt:=lp: 

Redirects  all  I/O  requests  for  device  LPO:  to  device  TTO:. 
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REMOVE 

Use  the  REMOVE  command  to  delete  a  task  name  and,  on  RSX-11M-PLUS 
systems,  a  region  name  from  the  System  Task  Directory.  Removing  a 
task  from  the  system  image  makes  the  task  unrecognizable  to  the 
system.  The  action  resulting  from  this  command  is  the  complement  of 
INSTALL . 

The  REMOVE  command  cannot  remove  an  active  task  from  a  saved  system. 
An  example  of  such  a  task  is  SAV;  an  attempt  to  remove  SAV  from  a 
saved  system  results  in  an  error  message. 

Format 

REM[OVE]  name [/REG] 

Parameters 

name 


The  name  of  the  task,  region,  or  directive  common  to  be  removed. 

/REG 

( RSX-11M-PLUS  systems  only.)  Specifies  that  the  name  parameter 
you  specify/ls  the  name  of  a  region. 

You  must  specify  this  keyword  when  removing  the  directive 
commons.  To  remove  the  commons,  use  the  following  command  line: 

UMR>REM  DIR1 1M/RFG 

Note  that  when  you  remove  DIR11M,  you  remove  all  of  the  directive 
commons  in  the  system. 

Example 

VhR>REM  SCAN 

Removes  the  task  named  SCAN  from  the  System  Task  Directory.  The 
task  image  file  remains  unaffected. 


Notes 

1.  If  a  task  or  region  that  is  the  object  of  a  REMOVE  command  is 
fixed,  the  command  automatically  unfixes  the  task  from  the 
system  image. 

2.  REMOVE  automatically  cancels  all  time-based  schedule  requests 
for  the  specified  task. 

3.  To  remove  a  command  line  interpreter  (CLI)  task,  you  must 
first  eliminate  the  CLI  Parser  Block  (CPB)  for  the  task  with 
the  MCR  CLI  /ELIM  command  on  the  running  system.  Then  use 
the  MCR  SAVE  command  to  update  the  system  image  file,  invoke 
VMR,  and  remove  the  CLI.  However,  it  is  recommended  that  you 
work  with  CLIs  exclusively  with  MCR  on  the  running 
system  —  this  includes  eliminating  and  removing  old  CLIs, 
and  installing  and  initializing  new  ones  —  and  then  save  the 
system . 
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An  exception  to  this  note  is  the  primary  MCR  task  ( MCR. . . ) • 
The  CPB  for  this  task  can  never  be  eliminated  and  the  task 
itself  can  be  removed  only  with  VMR. 

4.  On  RSX-11M-PLUS  systems,  a  region  cannot  be  removed  if  there 
are  tasks  installed  in  the  system  that  reference  that  region. 

5.  On  RSX-11M  systems,  changes  made  in  a  common  are  made  only  in 
the  memory  image  of  the  common.  Therefore,  a  common  does  not 
retain  changes  when  it  is  removed  and  then  reinstalled. 

6.  On  RSX-1 1M-PLUS  systems,  changes  made  in  the  memory  image  of 
a  common  can  be  preserved  when  the  common  is  removed  by 
installing  the  common  with  the  /WB=YES  option. 

If  the  common  is  installed  with  the  /WB=YES  option,  the 
REMOVE  command  writes  the  common,  with  its  changes,  into  its 
original  task  image  file,  replacing  the  original  image.  When 
the  common  is  reinstalled,  the  new  version  of  the  common  is 
placed  in  memory. 
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RUN 

Use  the  RUN  command  to  initiate  the  execution  of  an  installed  task. 
You  can  use  the  RUN  command  to  initiate  the  execution  of  a  task  at  any 
of  the  following  time  options: 

•  At  a  time  increment  from  the  system  image  time 

•  At  a  time  increment  from  clock  unit  synchronization 

•  At  an  absolute  time  of  day 

•  At  one  clock  tick  after  the  system  bootstrap 

Ail  of  these  options  are  available,  with  or  without  rescheduling. 
Each  option  has  a  separate  format. 

On  RSX-11M-PLUS,  you  cannot  run  a  task  whose  name  is  in  the  form 

...xxx  or  xxx$$$.  These  tasks  are  prototype  tasks,  which  are  never 

executed . 


NOTE 

The  correct  value  to  be  inserted  in  the  clock  queue 
for  Formats  1  through  3  is  derived  from  the  current 
value  of  the  system  time  stored  in  the  system  image. 
Therefore,  the  system  image  time  must  be  set  before 
any  RUN  requests  are  made  or  they  may  not  occur  at  the 
correct  time  after  the  system  is  bootstrapped. 


Format  1 

RUN  taskname  time  [/keyword ( s ) ] 

Runs  the  task  at  a  time  increment  from  the  system  image  time. 

Parameters 

taskname 

The  name  of  the  task.  A  task  name  must  be  1  to  6  characters. 


time 

The  number  of  time  units  added  to  the  current  system  image  time 
to  determine  the  time  at  which  the  task  will  run;  or,  when  used 
with  the  /RSI  keyword,  the  number  of  time  units  added  to  the  time 
of  the  task's  last  completed  run  to  determine  the  time  at  which 
the  task  will  rerun. 
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The  time  parameter  has  the  following  format: 
mu 

where : 


The  magnitude  or  number  of  time  units  to  be  clocked. 
The  maximum  number  of  time  units  you  can  specify 
depends  on  the  type  of  time  units  you  want  to  specify. 
You  can  specify  the  following  time  unit  magnitudes: 

•  If  you  are  specifying  hours,  m  can  be  any  positive 
number  from  0  to  24 (decimal). 

•  If  you  are  specifying  minutes,  m  can  be  any  positive 
number  from  0  to  1440 (decimal ) . 

•  If  you  are  specifying  seconds,  m  can  be  any  positive 
number  from  0  to  32767 ( decimal ) . 

•  If  you  are  specifying  clock  ticks,  m  can  be  any 
positive  number  from  0  to  32767 ( decimal ) . 

If  you  are  specifying  a  reschedule  interval  with  the 
/RSI  keyword  and  specify  a  magnitude  (m)  of  0,  the 
magnitude  defaults  to  1.  For  example,  specifying 
/RSI=0H  is  the  same  as  specifying  /RSI=1H. 

The  total  time  must  not  exceed  24  hours .  The  magnitude 
is  decimal  by  default. 


The  type  of  time  units  to  be  clocked.  You  can  use 
single  letters  to  specify  the  following  time  units: 

H  -  Hours 

M  -  Minutes 

S  -  Seconds 

T  -  Ticks 

A  tick  is  a  clock  interrupt.  The  rate  at  which 
interrupts  occur  depends  on  the  type  of  clock  installed 
in  the  system. 

For  a  line  frequency  clock,  the  tick  rate  is  either  50 
or  60  ticks  per  second,  corresponding  to  the  line 
frequency. 

For  a  programmable  clock,  a  maximum  of  1000  ticks  per 
second  is  available.  (The  frequency  is  selected  at 
system  generation.) 
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/keyword(s) 

One  or  both  of  the  following  keywords: 

/RSI=time 
/UIC=[ uic] 

Keywords 

/RSI=time 

Specifies  the  reschedule  interval.  The  reschedule  interval 
informs  the  system  when  you  want  it  to  rerun  the  task.  Each  time 
the  interval  of  time  you  specify  lapses,  the  system  issues  an 
initiation  request  for  the  task.  The  format  for  time  is  mu.  See 
the  description  of  the  time  parameter . 

The  default  is  no  rescheduling. 

/UIC=[uic] 

Specifies  the  UIC  for  the  task.  The  task's  UIC  determines  the 
file  protection  class  ( system, owner , group, world)  to  which  the 
task  belongs.  When  specifying  a  UIC,  you  must  use  square 
brackets  ( [  ] ) . 

The  default  is  the  UIC  established  for  pseudo  device  CO:. 

Format  2 

RUN  taskname  sync  [ time] [ /keyword ( s ) ] 

Runs  the  task  at  a  time  increment  from  clock  unit  synchronization. 

The  system  determines  the  task  run— time  by  waiting  for  the  specified 
time  unit  (sync)  and  then  waiting  for  the  specified  time  increment 
(time)  to  elapse. 

Parameters 

taskname 

The  name  of  the  task.  A  task  name  must  be  1  to  6  characters. 


sync 

Indicates  the  synchronization  unit.  You  can  specify 
following  synchronization  values: 


H  -  Synchronize  on  the  next  hour 

M  -  Synchronize  on  the  next  minute 

S  -  Synchronize  on  the  next  second 

T  -  Synchronize  on  the  next  tick 


time 

The  time  increment  value,  if  present,  is  added  to  the 
synchronization  value  to  produce  the  time  the  task  will  be  run. 
The  format  for  specifying  time  is  provided  in  Format  1. 
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/keyword ( s) 

One  or  both  of  the  following: 

/RSI=time 

/UIC=[uic] 

These  keywords  are  described  under  Format  1 . 
Format  3 

RUN  taskname  hh:mm:ss  [ /keyword ( s ) ] 

Runs  the  task  at  an  absolute  time  of  day. 


Parameters 

taskname 

The  name  of  the  task.  A  task  name  must  be  1  to  6  characters, 
hh :mm: ss 

The  absolute  time  of  day  at  which  the  task  will  be  run.  The 
letters  in  the  format  are  replaced  with  decimal  numbers  and 
indicate  the  following  time  units : 

hh  -  Hours 
mm  -  Minutes 
ss  -  Seconds 

/keyword (s) 

One  or  both  of  the  following: 

/RSI=time 

/UIC=[uic] 

These  keywords  are  described  under  Format  1. 

Format  4 

RUN  taskname  [/keyword ( s) ] 

Runs  the  task  one  clock  tick  after  the  system  bootstrap. 

Parameters 

taskname 

The  name  of  the  task.  A  task  name  must  be  1  to  6  characters. 
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/keyword ( s) 

One  or  both  of  the  following: 

/RSI=time 

/UIC=[uic] 

These  keywords  are  described  under  Format  1 • 

Examples 

1.  VMR>RUN  XKE  15M 

Runs  task  XKE  15  minutes  from  the  current  system  image  time. 

2.  VMR>RUN  XKF!  15M/RSI  =90S/U 10  =  13  t  1 1 

Runs  task  XKE  15  minutes  from  the  current  system  image  time, 
rescheduling  it  every  90  seconds.  The  task  is  running  under 
UIC  [3,1]. 

3.  VMR>RUN  XKE  H  5M/RSJ=1H 

Synchronizes  with  the  system  image  time  on  the  next  hour, 
runs  the  task  XKE  5  minutes  after  synchronization,  and 
reschedules  the  task  to  run  every  hour  after  the  last 
completed  run. 

4.  y M E > RUN  XKE  23? 55 *00 

Runs  task  XKE  at  5  minutes  before  midnight. 

5.  M M R > R LI N  XKE/RS I  =2H 

Runs  task  XKE  one  clock  tick  after  the  system  bootstrap  and 
reschedules  the  task  to  run  2  minutes  later. 
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Use  the  SAVE  command  to  write  the  image  of  a  system  onto  a  sequential 
b°°table  format.  By  using  the  SAVE  command,  you  can  copy  an 
Jr*"11?  system  °r  a  foreign  system  onto  a  tape  or  a  diskette.  You  can 
then  transport  the  magnetic  tape  or  diskette  to  another  computer  and 

n?  a  hardware  bootstrap.  (Refer  to  the  description 

of  the  /IM  switch  in  Section  10.4.)  F 


On  paper  tape,  system  images  are  created  in  absolute  loader  format  and 
must  be  bootstrapped  with  the  absolute  loader. 


Format 


SAV[E]  ddnn : [ label] [ /keyword ( s ) ] 
Parameters 
ddnn : 


The  device  unit  onto  which  the  system  image  is  written.  The  SAVE 
command  accepts  the  following  devices: 

CT:  Tape  cassette 

DD:  TU58  DECtape  II 

DT:  DECtape 

DU:  RX50  diskette/RA60  disk/RC25  disk  (removable) 

DX:  RX01  diskette 

DY:  RX02  diskette 

MM:  TE/TU16/TU45/TU77  magnetic  tape 

MS:  TS11/TSV05/TU80  magnetic  tape 

MT:  TE/TU10/TS03  magnetic  tape 

MU:  TK50  cartridge  tape/TU81  magnetic  tape 

PP  2  Paper  tape 

label 

Th®  file  label  name  that  must  be  specified  for  all  devices  except 
paper  tape.  The  label  name  can  be  1  to  12  alphanumeric 
characters . 


Keywords : 
/BOOT=type: 


Specifies  the  type  of  boot  block  being  used  when  the  system  image 
is  saved.  The  options  for  type  are  DX:  (for  RXOls)  and  DY: 
(for  RX02s ) . 


The  /BOOT  keyword  allows  you  to  use  an  RX01  drive  to  bootstrap  a 
system  that  was  saved  using  an  RX02  drive  in  single-density  mode, 
or  to  use  an  RX02  drive  to  bootstrap  a  system  that  was  saved 
using  an  RX01  drive  in  single— density  mode. 

If  you  do  not  use  /BOOT,  the  boot  block  for  the  type  of  device 
being  used  is  written  to  the  device. 
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/DENS=1600 

Specifies  the  bits  per  inch  (bpi)  density  for  the  following 
9-track  magnetic  tapes: 

TE16  TUI 6  TU45  TU77 

These  tapes  use  the  device  mnemonic  MM:. 

Example 

VMR >8 AM  MTtMYSYS 

In  this  example,  the  system  image  is  written  onto  MT:  in 
bootable  format.  System  changes  made  by  other  VMR  commands  are 
also  saved  with  the  system  image. 


Notes 


1.  On  RSX-11M  and  RSX-11S  systems,  the  maximum  memory  size  of  a 
system  is  124K -words.  The  SAVE  command  limits  the  size  of 

mapped  systems  for  certain  devices.  If  a  mapped  system  is 
saved  and  its  memory  size  is  greater  than  the  maximum  size 
imposed  by  the  SAVE  command  for  the  specified  device,  only 
the  amount  of  memory  equal  to  the  maximum  size  (starting  at 
physical  location  0)  is  saved. 

The  devices  for  which  the  SAVE  command  imposes  a  maximum  size 
on  saved  system  images  are  as  follows: 


Paper  tape  punch  (PP:) 
Cassette  tape  (CT:) 
RX01  diskette  (DX:) 


28K-words 

28K-words 

123K-words 


RX02  diskette  (DY:) 


123K-words 


2.  When  you  save  RSX-11S  systems  on  paper  tape  and  you  do  not 
apply  the  /IM  switch  to  the  system's  file  name  (refer  to 
Section  10.4  for  a  description  of  the  /IM  switch),  the  last 
1000 (octal)  bytes  of  the  system  image  are  not  written  out. 
This  allows  space  to  accommodate  the  absolute  loader .  When 
you  specify  the  /IM  switch  with  the  system's  file  name,  the 
entire  system  image  is  written  to  paper  tape.  In  this  case, 
it  is  your  responsibility  to  ensure  that  the  system  image  is 
not  so  large  that  it  overwrites  the  absolute  loader . 


3,  When  you  bootstrap  systems  on  media  other  than  paper  tape, 
regardless  of  the  size  of  the  system  image,  the  last 
1000 (octal)  bytes  of  physical  memory  are  not  copied  to 
accommodate  the  bootstrap. 
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4.  When  you  save  a  system  on  paper  tape,  contiguous  blocks  that 
contain  only  zeros  and  begin  on  a  32-word  address  are 
compressed  into  two  words  that  contain  the  zero  count.  This 
compression  significantly  reduces  both  the  amount  of  paper 
tape  required  and  the  time  expended  to  create  the  tape  and 
read  it  into  memory.  After  the  entire  image  has  been  loaded 
into  memory,  a  short  routine  writes  zeroes  into  the 
appropriate  blocks  of  memory  before  passing  control  to  the 
bootstrapped  system . 

5.  Systems  saved  on  a  TE/TU10/TS03  9-track  magnetic  tape  drive 
can  be  bootstrapped  from  a  TE/TU16  drive,  and  the  reverse. 

6.  When  you  specify  the  /IM  switch  with  the  system  file 
specification,  the  SAVE  command  always  uses  a  bootstrap  that 
does  not  enable  memory  management. 

7.  None  of  the  bootstraps  require  that  a  target  RSX-11S  system 
have  a  driver  for  the  bootstrap  device. 

8.  Unless  you  specify  /DENS=1600,  when  you  save  a  system  image 
to  a  magnetic  tape  drive  that  supports  multiple  densities, 
the  drive  is  forced  to  800  bpi  before  the  SAVE  operation  is 
started . 
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Use  the  SET  command  to  alter  a  number  of  system-wide 
The  SET  command  allows  you  to  do  the  followings 

•  Set  device  characteristics  for  devices 

•  Set  default  UICs  for  terminals 

•  Set  system  UIC 

•  Set  and  display  terminal  status 

•  Create  and  eliminate  partitions 

•  Add  space  to  the  system  dynamic  memory 

•  Enable  write-checking  and  seek  optimization 
support  it 


characteristics . 


on  devices  that 


When  using  the  SET  command,  a  situation  can  arise  in  which  the  system 
fails  to  accept  privileged  user  input.  To  avoid  this,  the  system 
should  have  at  least  one  nonslaved  terminal  and  one  privileged 
terminal.  You  need  a  privileged  terminal  because  nonprivileged 
terminals  cannot  enter  privileged  commands.  You  need  a  nonslaved 
terminal  because  slaved  terminals  cannot  enter  unsolicited  input  to 
MCR .  For  more  information,  see  the  description  of  the  /SLAVE  keyword. 

On  RSX-11M  systems,  a  number  of  SET  keywords  require  Executive 
features  that  must  be  included  at  system  generation.  If  you  specify  a 
keyword  that  requires  a  feature  not  generated  into  the  system  image, 
the  SET  command  has  no  effect  and  results  in  an  error  message.  Some 
of  the  SET  keywords  that  require  Executive  features  are  /CRT,  /ESCSEQ, 
/LOWER,  and  /WCHK . 

In  addition,  some  of  the  SET  keywords  are  supported  with  the 
full-duplex  terminal  driver  only.  The  full-duplex  terminal  driver  is 
a  system  generation  option  for  RSX— 11M  systems,  but  is  always  included 
in  RSX-1 1M-PLUS  systems.  Note  that  if  you  select  the  full-duplex 
driver  on  RSX-11M,  you  must  also  select  the  GET/SET  Multiple 
Characteristics  option  to  SET  or  display  any  terminal-related 
characteristics . 

VMR  permits  only  one  keyword  per  command  line.  You  can  prefix  most 
keywords  by  NO  to  negate  or  disable  the  function  of  the  keyword.  VMR 
returns  a  syntax  error  message  when  NO  precedes  a  keyword  for  which  it 
is  illegal. 

Examples  of  the  SET  command  follow  the  keyword  descriptions . 

Format 

SET  /keyword[=value] 
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Parameter 
/keyword [= value] 

The  following  table  provides  a  functional  listing  of  the  SET 
keywords .  You  can  use  one  keyword  per  command  line  with  the  SET 
command . 


Table  10-2 

SET  Keywords 

Type 

Keywords 

Device 

Characteristics 

/ABAUD[=ttnn:] 

/ ANSI [=ttnn  s ] 

/AV0[=ttnn: ] 

/BLKMOD[=ttnn:] 

/BRO[=ttnn: ] 

/BUF=ddnn; [size] 

/CRT[=ttnn: ] 

/DEC[=ttnn:] 

/EBC[=ttnn: ] 

/ECHO[=ttnn:] 

/EDIT[=ttnn:] 

/ESCSEQ[=ttnn:] 

/FDX[=ttnn:] 

/ FORMFEED[ =ttnn : ] 

/HFILL=ttnn: [value] 

/HHT[=ttnn:] 

/HSYNC[=ttnn:] 

/LINES=ddnn: [value] 

/LOWER[=ttnn: ] 

/OPT[=ddnn  sopttyp] 

/PARITY[=ttnn : [option] ] 

/PASTHRU[=ttnn: ] 

(continued  on  next  page) 
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Table  10-2  (Cont.) 

SET  Keywords 

Type  Keywords 

Device  /PRINTER_PORT[=ttnn:  ] 

Characteristics 

(cont.)  /PRIVOttnn:] 


/PUB[=ddnn: ] 
/REGIS[=ttnn: ] 

/ REMOTE [=ttnn: [speed]] 
/RPAC=ttnn: ] 
/SERIAL[=ttnn:] 

/ SLAVE [=ttnn : ] 

/ SOFT [ =t tnn : ] 

/ SPEED= tt nn : [ rec v : xmit ] 
/TERM=ttnn: [type] 
/TTSYNC[=ttnn:] 
/TYPEAHEAD [ =t tnn : [ s i ze ] ] 
/UIC=[[uic] : ] :ttnn: 
/VFILL[=ttnns] 
/WCHK[=ddnn:] 

/WRAP [=t tnn:] 

Enable/Disable  /LOGON 

Login 


Library,  Network, 
or  System  UICs 

/SYSUIC[=[uic]] 

Memory  /AFF=CUNIBUS— mask] 

Allocation 

( see  Notes )  /BOT=pname : value 

/MAIN=pname[ :base: size: type] 

/NOMAIN=pname 

/MAXEXT[=size] 


/LIBUICOCuic]] 

/NETUIC[=[uic]] 


(continued  on  next  page) 
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Type 

Keywords 

Memory 

/PAR=pname[ :base:size[ :typel] 

Allocation 

( cont . ) 

/ NOP AR=pname 

/P00L[=top] 

/ POOLSI ZE [ = val ue ] 

/ SECPOL 

/ SUB=mname : sname[ :base : size] 

/NOSUB=mname : sname 

/ T0P=pname : value 

Pool 

/PLCTL[=[high] [ : [ low] [ : [ f rsiz 

][ sbasep]]]] 

Monitor  Task 

System 

/RNDC[=nn] 

Tuning 

/RNDH[=nn] 

/RNDL[=nn] 

/SWPC[=nn] 

/ SWPR[=nn] 

Keywords : 

/ABAUDOttnn:] 

(Full-duplex  terminal  driver  only.)  Enables  autobaud  detection 
for  the  remote  dial-up  line  for  the  specified  terminal.  The 
terminal  driver  samples  the  line's  first  input  character,  tries 
to  determine  the  incoming  speed,  and  sets  the  interface  speed 
accordingly. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  with  autobaud  detection. 

/NOABAUD[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Disables  autobaud  detection 
for  the  specified  terminal.  The  terminal  driver  does  not  attempt 
to  determine  the  incoming  speed  for  the  remote  dial-up  line . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  autobaud  detection. 
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/AFF=[UNIBUS-run-mask, . . . ] 

( RSX-11M-PLUS  multiprocessor  systems  only.)  Specifies  which  I/O 
page  will  contain  the  device  partition.  This  keyword  is  required 
for  creating  device  partitions  on  the  system. 

You  must  specify  at  least  one  URM.  Enclose  the  URM(s)  in  square 
brackets  ([  ]). 

If  you  specify  more  than  one  URM,  you  must  separate  them  by 
commas.  For  example: 

/ AFF=[UBE , UBF , UBH] 


UNIBUS-r un-mask 


The  three- letter  name  of  the 
partition  is  associated.  The 
specifications : 


URM  with 
following 


which  the  device 
names  are  valid  URM 


CPA 

UBE 

UBK 

UBP 

CPB 

UBF 

UBL 

UBR 

CPC 

UBH 

UBM 

UBS 

CPD 

UBJ 

UBN 

UBT 

You 

must 

specify 

at  least 

one  URM.  If 

you  specify  more  than  one 

URM, 

you 

must  separate  them  by  commas . 

You 

must 

enclose 

the  URM 

specification 

in  square  brackets  ([  ]). 

For  example,  to  create  a  device  partition  that  is  mapped  to  CPA  s 
I/O  page,  enter  the  following  command  line: 

SET  / PAR=DEVP :177600:200: DEV/AFF=[CPA] 


/ ANS I [ =ttnn : ] 


(Full-duplex  terminal  driver  only.)  Informs  the  system  that 
specified  terminal  supports  ANSI  escape  sequences. 


the 


When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  ANSI  characteristic  set. 


/NOANSI [=ttnn : ] 


(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  does  not  support  ANSI  escape  sequences. 


When  you  omit  the  terminal  specification,  VMR  displays  all 
terminals  that  do  not  have  the  ANSI  characteristic  set. 


/AVO[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  VTlOO-series  terminal  has  the  advanced  video  option. 


This  option  gives  the  terminal  the  capability  to  blink,  bold,  and 
flash  parts  of  the  screen,  and  to  set  the  screen  at  132(decimal) 
columns . 
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If  the  word  SET-UP  blinks  in  set-up  mode,  the  terminal  has  the 
advanced  video  option.  See  your  system  manager  for  more 
information. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  advanced  video  option. 

/NOAVO[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  does  not  have  the  advanced  video  option. 

When  you  omit  the  terminal  specification,  VMR  displays  all 
terminals  that  do  not  have  the  advanced  video  option. 

/BLKMOD[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Enables  local  editing  and 
block-mode  transmission  for  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  block-mode  option  enabled. 

/NOBLKMOD[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Disables  local  editing  and 
block-mode  transmission  for  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  block-mode  option  disabled. 

/ BOT=pname : val ue 

Directs  VMR  to  move  the  bottom  boundary  of  the  specified 
system-controlled  partition  (pname)  up  or  down  the  amount 
indicated  by  the  value  parameter.  The  /BOT  keyword  modifies  the 
bottom  boundary  of  a  partition  even  though  it  has  tasks  installed 
in  it.  If  you  modify  the  partition  so  that  it  becomes  too  small 
to  hold  the  tasks  installed  in  it,  VMR  displays  a  warning  message 
but  modifies  the  partition  anyway. 

pname 

The  1-  to  6-character  alphanumeric  partition  name. 

value 


The  number  of  64-byte  blocks . 

The  value  parameter  can  be  supplied  in  five  formats : 
+value,  -value,  value,  +*  or  *,  and  -*.  These  are  described 
as  follows: 

+value 

Moves  the  partition ' s  bottom  boundary  up  the  amount 
indicated  by  the  specified  value.  Moving  the  bottom 
boundary  up  makes  the  partition  smaller. 
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NOTE 


You  must  supply  the  value  in  the  same  units  as 
those  of  the  base  and  size  parameters  for  the 
/PAR  keyword. 


-value 


Moves  the  partition's  bottom  boundary  down  the  amount 
indicated  by  the  specified  value.  Moving  the  bottom 
boundary  down  makes  the  partition  larger . 


value 


Moves  the  partition's  bottom  boundary  until  the  total 
partition  size  is  equal  to  the  specified  value. 


+*  or  * 


Moves  the  partition's  bottom  boundary  up  as  far  as 
possible.  Note  that  using  this  format  will  cause  the 
bottom  boundary  to  move  up  to  the  bottom  of  the  first 
fixed  task  or  fixed  driver  loaded  into  the  partition  at 
the  time  the  /BOT  keyword  is  executed.  If  there  is 
nothing  loaded  into  the  partition,  it  assumes  a  size  of 
one  64-byte  block. 


Moves  the  partition's  bottom  boundary  down  as  far  as 
possible.  Using  this  format  will  cause  the  bottom 
boundary  of  the  partition  to  move  down  to  the  top 
boundary  of  the  partition  below  it,  or  to  the  top  of 
the  Executive  pool  if  the  partition  is  the  lowest 
partition  in  memory. 


/BRO[=ttnn:] 


Enables  the  broadcast  option  for  the  specified  terminal.  The 
terminal  can  receive  messages  sent  from  other  terminals  with  the 
MCR  BROADCAST  command. 


When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  can  receive  messages. 


The  /BRO  keyword  is  valid  only  on  systems  with  multi-CLI  support . 


/NOBRO[=ttnn:] 


Disables  the  broadcast  option  for  the  specified  terminal.  The 
terminal  cannot  receive  messages  sent  from  other  terminals. 


When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  cannot  receive  messages. 


The  /NOBRO  keyword  is  valid  only  on  systems  with  multi-CLI 
support . 
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/BUF=ddnn: [size] 

Sets  the  default  buffer  size  of  the  specified  device.  The  size 
you  specify  must  be  from  0  to  255 (decimal) .  (For  a  terminal,  the 
size  you  specify  must  be  greater  than  or  equal  to  15 (decimal )) . 
The  /BUF  keyword  is  particularly  useful  for  defining  line  printer 
width  (for  example,  80  or  132  columns). 

When  you  omit  the  size  specification,  VMR  displays  the  current 
buffer  size  of  the  device. 

/ CRT[=ttnn : ] 

Informs  the  system  that  the  specified  terminal  is  a  cathode  ray 
tube  (CRT)  terminal  and  enables  the  backwards  deletion  option. 

When  the  backwards  deletion  option  is  enabled,  pressing  the 
RUBOUT  or  DELETE  key  moves  the  printing  position  one  space  to  the 
left  and  erases  any  character  displayed  in  that  position. 


When  you  omit  the  terminal  specification, 
terminals  that  are  defined  as  CRTs. 

VMR 

displays 

all 

the 

/NOCRT [ =ttnn : ] 

Informs  the  system  that  the  specified  terminal 
disables  the  backwards  deletion  option. 

is  not  a 

CRT 

and 

When  you  omit  the  terminal  specification, 
terminals  that  are  not  defined  as  CRTs. 

VMR 

displays 

all 

the 

/DEC[=ttnn: ] 


(Full-duplex  terminal  driver  only.)  Indicates  that  the  specified 
terminal  is  upward-compatible  with  the  VTlOO-series  of  terminals. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  are  upward-compatible. 

/NODEC[=ttnns] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  is  not  upward-compatible  with  the  VTlOO-series 
of  terminals. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  are  not  upward-compatible. 

/EBC[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Enables  the  8-bit  character 
option.  The  terminal  driver  passes  all  eight  bits  of  the 
characters  to  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  8-bit  character  option  enabled. 
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/NOEBC[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Disables  the  8-bit  character 
option.  The  terminal  driver  clears  the  eighth  bit  of  the 
characters  before  passing  them  to  the  device. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  8-bit  character  option  enabled. 

/ECHO[=ttnn:] 

Enables  the  echo  option.  The  terminal  driver  displays  each 
character  that  is  typed  on  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  echo  option  enabled. 

/NOECHO [=ttnn : ] 

Disables  the  echo  option.  The  terminal  driver  does  not  display 
the  characters  that  are  typed  on  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  echo  option  disabled. 

/EDIT[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  can  perform  ANSI-defined  advanced  editing 
functions .  The  VT102  is  an  example  of  such  a  terminal . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  can  perform  the  advanced  editing  functions. 


/NOEDIT[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  cannot  perform  ANSI-defined  advanced  editing 
functions . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  cannot  perform  the  advanced  editing  functions • 

/ESCSEQ[=ttnn:] 

Enables  the  recognition  of  escape  sequences  from  the  specified 
terminal.  The  terminal  driver  treats  the  ESC  character  as  the 
beginning  of  an  escape  sequence  rather  than  as  a  line  terminator. 
(See  the  RSX-11M/M-PLUS  I/O  Drivers  Reference  Manual  for  further 
information  about  escape  sequences . ) 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  recognize  escape  sequences. 

/NOESCSEQ[=ttnn: ] 

Disables  the  recognition  of  escape  sequences  at  the  specified 
terminal . 

When  you  omit  the  terminal  specification/  VMR  displays  all  the 
terminals  that  do  not  support  the  recognition  of  escape 
sequences . 
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/FDX[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Enables  the  full-duplex 
option.  The  terminal  driver  accepts  input  from  the  specified 
terminal  while  simultaneously  outputting  to  it. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  full-duplex  option  enabled. 

/NOFDX[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Disables  the  full-duplex 
option .  The  terminal  driver  will  not  process  input  and  output 
from  the  specified  terminal  simultaneously. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  full-duplex  option  enabled. 

/FORMFEED[=ttnn:] 

Informs  the  system  that  the  specified  terminal  supports  a 
hardware  form  feed. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  support  hardware  form  feeds. 

/NOFORMFEED [=ttnn : ] 

Informs  the  system  that  the  specified  terminal  does  not  support  a 
hardware  form  feed. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  do  not  support  hardware  form  feeds . 

/HFILL=ttnn : [value] 

(Full-duplex  terminal  driver  only.)  Specifies  the  number  of  fill 
characters  (value)  that  the  terminal  driver  is  to  place  after  a 
carriage  return  when  outputting  to  the  specified  terminal.  The 
value  is  a  number  from  0  through  7. 

When  you  omit  the  value  parameter,  VMR  displays  the  number  of 
fill  characters  currently  being  output  by  the  terminal  driver  to 
the  specified  terminal . 

/HHT[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Indicates  that  the  specified 
terminal  supports  a  hardware  horizontal  tab. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  support  a  hardware  horizontal  tab. 

/NOHHT[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Indicates  that  the  specified 
terminal  does  not  support  a  hardware  horizontal  tab. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  support  a  hardware  horizontal  tab. 
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/HSYNC[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Enables  host-terminal 
synchronization . 

Host-terminal  synchronization  controls  the  typeahead  buffer  to 
prevent  it  from  overflowing.  When  the  typeahead  buffer  is  full, 
the  system  temporarily  locks  the  terminal  keyboard  by  generating 
a  CTRL/S  which  prevents  you  from  entering  more  information. 

Once  the  terminal  is  able  to  transmit  all  of  the  information  in 
the  typeahead  buffer  to  the  operating  system,  the  system  unlocks 
the  keyboard  by  generating  a  CTRL/Q  which  allows  the  terminal  to 
receive  input. 

The  /HSYNC  keyword  is  recommended  for  users  with  terminals  that 
transmit  information  in  blocks,  for  example,  the  DIGITAL  VT131 
and  VT132  terminals.  It  is  also  recommended  for  users  with 
terminals  that  emulate  these  models.  If  you  do  not  have  one  of 
these  terminals  it  is  unlikely  that  you  will  fill  the  typeahead 
buffer.  To  change  the  size  of  your  typeahead  buffer,  use  the 
/TYPEAHEAD  keyword. 

/HSYNC  is  the  default  for  the  VTlOO-series  of  terminals. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  host- terminal  synchronization. 

/NOHSYNC[=ttnns] 

(Full-duplex  terminal  driver  only.)  Disables  host-terminal 
synchronization  for  the  specified  terminal. 

Disabling  synchronization  means  that  when  the  typeahead  buffer 
for  the  terminal  is  full,  the  system  does  not  lock  the  keyboard, 
and  subsequent  input  is  lost . 

/NOHSYNC  is  the  default  for  VT52  terminals. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  host-terminal  synchronization. 

/LIBUIC[=[uic]] 

( RSX— 11M-PLUS  systems  only.)  Directs  the  INSTALL  command  to 
search  the  specified  UIC  in  response  to  a  RUN  $file  or  INS  $file 
command  when  the  file  is  not  in  the  system  UIC. 

The  UIC  is  in  the  format  [g,m],  where  g  and  m  are  octal  numbers 
from  1  through  377 (octal)  that  represent  a  group  and  member 
number,  respectively.  You  must  use  square  brackets  ([  ]).  When 
you  omit  the  UIC  specification,  VMR  displays  the  current  library 
UIC. 

The  default  library  UIC  is  [3,54]. 
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/LINES=ddnn: [value] 

(Full-duplex  terminal  driver  only.)  Establishes  the  number  of 
lines  per  page  on  the  specified  device.  The  value  is  a  number 
from  1  through  255 (decimal ) .  If  you  specify  a  number  that  is 
larger  than  the  number  of  lines  per  page  possible  for  a  given 
device,  VMR  defaults  to  the  largest  number  possible  for  that 
device . 

When  you  omit  the  value  parameter,  VMR  displays  the  lines  per 
page  for  the  specified  device. 

/LOGON 

Enables  logging  in  on  terminals  in  a  multiuser  protection  system. 

/LOGON  and  /NOLOGON  clear  and  set  a  flag  checked  by  the  HELLO 

command  when  a  user  attempts  to  log  in  on  a  terminal . 

/NOLOGON 

Disables  logging  in  on  terminals  in  a  multiuser  protection 
system. 

/LOGON  and  /NOLOGON  clear  and  set  a  flag  checked  by  the  HELLO 

command  when  a  user  attempts  to  log  in  on  a  terminal. 

/NOLOGON  provides  a  means  of  preventing  users  from  accessing  the 
system  during  such  activities  as  system  maintenance  or  account 
file  maintenance. 

/LOWERC =ttnn:J 

Specifies  that  lowercase  characters  are  not  converted  to 
uppercase  when  received  from  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  for  which  lowercase  characters  are  not  converted. 

/NOLOWER[=ttnn:] 

Resets  the  terminal  characteristics  of  the  specified  terminal  so 
that  lowercase  characters  received  on  input  are  automatically 
converted  to  uppercase  and  echoed  as  uppercase. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  for  which  conversion  to  uppercase  is  specified. 

/MAIN=pname[ :base : size : type] 

(RSX-11M  systems  only.)  Establishes  a  main  partition. 

pname 

The  1-  to  6-character  alphanumeric  partition  name. 

base 

The  physical  base  address  of  the  partition  specified  as  a 
number  of  64-byte  blocks . 
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size 

The  size  of  the  partition  specified  as  a  number  of  64-byte 
blocks.  The  maximum  size  is  0  to  1920K -words  for  a  task,  common, 
or  main  partition. 

type 

The  partition  type.  You  can  assign  the  following  partition 
types : 


SYS 

Assign  an  SYS  partition  type  for  a  main  partition. 
Main  partitions  are  allocated  for  user  tasks  and 
loadable  drivers . 

COM 

Assign  a  COM  partition  type  for  a  common  partition. 

DEV 

Assign  a  DEV  partition  type  for  a  common  partition  that 
maps  the  device  registers.  Device  partitions  are 
allocated  for  device  commons  that  are  used  by  tasks  to 
access  the  device  registers  on  the  I/O  page. 

TASK 

Assign  a  TASK  partition  type  for  a  task  partition. 

You  can  enter  base  and  size  in  any  of  the  following  formats: 
Format  Calculated  Value 


nnnn 
nnnn . 
nnnK 
nnn  .K 


Octal  (nnnn*100) 
Decimal  ( nnnn . *64 . ) 
Octal  K  (nnn*4000) 
Decimal  K  (nnn. *2048.) 


where  nnnn  is  a  number  to  which  a  multiplication  factor  is 
applied  to  determine  the  value  used.  Valid  ranges  of  calculated 
values  are: 


Octal 
Decimal 
Octal  K 
Decimal  K 


0<=base< 177777 
0 . <=base<65535 
0K<=base<3777K 
0 . K<=base<2047  .K 


0<size<2000 
0 . <size<1024 . 
0K<size<40K 
0 .K<size<32 .K 


For  system-controlled  partitions,  size  may  range  from  0  to  1920K 
or  any  valid  representation  of  these  limits . 

You  can  specify  the  base  address  of  a  partition  with  a  wildcard 
(*)  for  TASK  or  SYS  partitions  in  a  mapped  system.  When  you 
specify  a  wildcard,  VMR  creates  a  partition  at  the  lowest  address 
possible  for  a  partition  of  the  size  you  have  specified. 
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You  can  also  specify  the  size  of  a  partition  with  a  wildcard  for 
SYS  partitions.  When  you  specify  the  wildcard,  VMR  creates  the 
largest  possible  partition  starting  at  the  base  address  you  have 
specified  in  the  base  parameter. 

When  you  specify  wildcards  for  both  the  base  and  size,  VMR 
creates  a  partition  that  completely  fills  the  first  gap  in  the 
existing  partition  layout. 

If  you  do  not  specify  base,  size,  or  type,  VMR  displays  the 
values  of  these  parameters  for  the  named  partition.  If  the  named 
partition  is  a  main  task-controlled  partition,  VMR  also  displays 
the  parameters  of  all  its  subpartitions. 

/ NOMAIN=pname 

(RSX-11M  systems  only.)  Eliminates  a  named  main  partition  from 
the  system.  The  partition  you  specify  is  eliminated  from  the 
list  of  partitions  and  the  system.  If  any  tasks  or  commons  are 
installed  in  or  attached  to  the  partition,  the  partition  is  not 
eliminated  and  VMR  generates  an  error  message. 

/MAXEXT[=size] 

Establishes  the  maximum  size  to  which  a  task  can  extend  itself 
beyond  its  mapped  array  area  by  means  of  the  EXTEND  TASK 
directive.  (See  the  RSX-11M/ M- PLUS  and  Micro/RSX  Executive 
Reference  Manual  for  a  description  of  the  directive . )  The  size  is 
given  in  units  of  32 (decimal) -word  blocks.  The  maximum  size 
allowed  is  1777(octal)  for  systems  without  memory  management  and 
177777 (octal )  for  systems  with  memory  management. 

You  can  specify  size  in  the  following  formats: 

Specified  Resulting 


Size 

Size 

n 

(n*100)  octal 

n. 

(n*64.)  decimal 

nK 

(n*4000)  octal 

n.K 

( n*2048 . )  decimal 

* 

1777 (octal)  maximum  for  systems  without  PLAS 
177777 (octal)  maximum  for  systems  with  PLAS 

When  you  omit  the  size  specification,  VMR  displays  the  current 
maximum  extension  size  in  100 (octal) -byte  units. 

The  /MAXEXT  keyword  is  valid  only  on  mapped  RSX-11M  systems  that 
have  selected  the  EXTEND  TASK  directive  option  during  system 
generation  and  on  all  RSX-11M-PLUS  systems.  However,  you  can  use 
both  the  unmapped  and  mapped  versions  of  VMR  to  establish  the 
maximum  extension  size  for  tasks . 

/NETUIC[=[uic]] 

Specifies  the  UIC  in  which  all  DECnet-related  tasks  are  stored. 
The  /NETUIC  keyword  applies  only  to  systems  that  select  the 
external  communication  products  option  during  system  generation . 
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The  UIC  is  in  the  format  [g,m],  where  g  and  m  are  octal  numbers 
from  1  to  377 (octal)  that  represent  a  group  and  member  number, 
respectively*  You  must  use  sguare  brackets  (E  D) • 

When  you  omit  the  UIC  specification,  VMR  displays  the  current 
network  UIC. 

/OPT[=ddnn  sopttyp] 

( RSX-1 1M-PLUS  systems  only.)  Enables  disk  I/O  queue  optimization 
for  the  specified  device. 

For  more  information  on  optimization  and  on  the  algorithm 
(opttyp)  parameter  for  this  keyword,  see  Chapter  16. 

ddnn: 

The  device  that  will  use  I/O  queue  optimization.  Legal 
devices  are  DB:-,  DL: - ,  DM:-,  and  DR: -type  devices.  When 
you  do  not  specify  a  device,  VMR  displays  all  the  devices 
that  use  optimization. 

opttyp 

The  algorithm  for  optimization.  The  algorithms  are: 

NEAR[EST] 

elevEator] 

CSCAN 

The  default  algorithm  set  at  system  generation  is  NEAR. 
/NOOPTE=ddnn: ] 

( RSX-1 1M-PLUS  systems  only.)  Disables  disk  I/O  queue  optimization 
for  the  specified  device. 

When  you  omit  the  device  specification,  VMR  displays  all  the 
devices  that  do  not  use  I/O  queue  optimization. 

/PAR=pnameE :base:sizeE  stype]] 

(RSX-11M-PLUS  systems  only.)  Establishes  a  partition. 

pname 

The  1-  to  6-character  alphanumeric  partition  name. 

base 

The  physical  base  address  of  the  partition  specified  as  a 
number  of  64-byte  blocks  or  as  a  wildcard  (*). 

size 

The  size  of  the  partition,  specified  as  a  number  of  64-byte 
blocks  or  as  a  wildcard  (*). 

The  size  can  range  from  1  to  170000 (octal )  ( 1920K-words ) , 

minus  the  size  of  the  Executive  and  other  partitions  in  the 
system. 
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type 

The  partition  type.  You  can  assign  the  following  partition 
types : 

SYS 

Assign  a  SYS  partition  type  for  a  main  partition.  Main 
partitions  are  allocated  for  user  tasks  and  loadable 
drivers . 

SECPOL 

Assign  a  SECPOL  partition  type  for  a  secondary  pool 
partition.  Pool  partitions  are  allocated  for  secondary 
pool . 

DEV 

Assign  a  DEV  partition  type  for  a  common  partition  that 
maps  the  device  registers.  Device  partitions  are 
allocated  for  device  commons  that  tasks  use  to  access 
the  device  registers  on  the  I/O  page.  Note  that 
creating  a  device  partition  automatically  creates  a 
main  partition  named  10  PAR,  which  spans  the  entire  I/O 
page.  The  partition  you  specify  with  the  /PAR  keyword 
then  becomes  a  subpartition  of  10  PAR.  0n 

multiprocessor  systems,  you  must  use  the  /AFF  keyword 
to  specify  which  I/O  page  contains  the  device 
partition. 

CPU 

Assign  a  CPU  partition  type  for  CPU  partitions.  CPU 
partitions  are  allocated  on  multiprocessor  systems  to 
store  vectors  for  all  the  devices  associated  with  the 
particular  processor. 

The  partition  type  is  optional.  However,  if  you  do  not  specify  a 
partition  type,  SYS  is  the  default  partition  type  assigned. 

You  can  enter  the  base  and  size  in  any  of  the  following  formats: 

Format  Calculated  Value 

nnnn  Octal  (nnnn*100) 

nnnn.  Decimal  (nnnn. *64.) 

nnnK  Octal  K  (nnn*4000) 

nnn.K  Decimal  K  (nnn.*2048.) 

where  nnnn  is  a  number  to  which  a  multiplication  factor  is 
applied  to  determine  the  value  used. 

When  you  are  establishing  the  base  and  size  for  a  CPU  partition, 
note  that  the  entire  CPU  partition  must  exist  below  124K. 
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For  SYS  partitions,  size  can  range  from  0  to  1920K  or  any  valid 
representation  of  these  limits.  For  example,  the  following 
inputs  for  size  allocate  a  2048 (decimal ) -byte  partition: 

40 

32. 

IK 

l.K 

You  can  specify  the  base  address  of  a  partition  with  a  wildcard 
(*).  When  you  specify  a  wildcard,  VMR  creates  a  partition  at  the 
lowest  address  possible  for  a  partition  of  the  size  you  have 
specified . 

You  can  also  specify  the  size  of  a  partition  with  a  wildcard. 
When  you  specify  a  wildcard,  VMR  creates  the  largest  possible 
partition  starting  at  the  base  address  you  specified  m  the  base 
parameter . 

When  you  specify  a  wildcard  for  a  CPU  partition,  VMR  creates  a 
partition  of  size  (n-l)*4K,  where  n  is  the  number  of  processors 
specified  during  system  generation. 

When  you  specify  wildcards  for  both  the  base  and  size,  VMR 
creates  a  partition  that  completely  fills  the  first  gap  in  the 
existing  partition  layout. 

If  you  do  not  specify  base,  size,  or  type,  VMR  displays  the 
values  of  these  parameters  for  the  named  partition.  If  the  named 
partition  is  a  main  partition,  VMR  also  displays  the  parameters 
of  all  its  subpartitions. 

/ NOP AR=pname 

(RSX-11M-PLUS  systems  only.)  Eliminates  a  named  partition  from 
the  system.  The  partition  you  specify  is  eliminated  from  the 
list  of  partitions  and  the  system.  If  any  tasks  or  commons  are 
installed  in  or  attached  to  the  partition,  the  partition  is  not 
eliminated,  and  VMR  generates  an  error  message. 


/PARITY[=ttnn: [option]] 

Enables  parity  generation  and  checking . 
selects  the  state  of  the  parity  bit. 


The  option  you  specify 


Parity  checking  is  used  to  verify  the  transmission  of  data 
between  a  terminal  and  the  operating  system.  Verification  occurs 
by  sending  an  extra  bit  with  each  character  called  the  parity 
bit,  which  serves  as  a  check  that  the  transmitted  character  was 
received  properly. 

If  you  do  not  enable  parity  checking,  parity  bits  are  not 
transmitted. 

The  options  for  /PARITY  are  EVEN  and  ODD.  The  state  of  the 
parity  bit,  which  is  either  0  or  1,  is  determined  by  the  option 
you  specify.  If  you  do  not  specify  an  option,  VMR  defaults  to 
EVEN. 
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If  you  specify  /PARITY=ttnn : EVEN ,  either  a  0  or  1  is  added,  to 

mthe  t0tal  number  of  "1 "  bits  even.  If  you  specify 
/  RITY  ttnniODD,  either  a  0  or  1  is  added,  to  make  the  total 
number  of  1  bits  odd.  The  system  checks  parity  on  input  from  a 
terminal.  The  terminal  checks  parity  on  output  from  the  system. 


A  parity  check  does  not  return  an  error  when  an  EVEN  parity  is 
specified  and  an  even  number  of  bits  are  counted,  or,  when  an  ODD 
parity  is  specified  and  an  odd  number  of  bits  are  counted. 

Note  that  the  terminal  hardware  must  be  set  to  the  same  mode  of 
parity  generation  and  checking  as  the  system  for  correct  data 
transmission  to  occur.  On  the  VT200-series  of  terminals,  this  is 
done  through  the  terminal ' s  SET-UP  mode . 


The  /PARITY  keyword  is  not  related  to  the  /EBC  keyword.  The 
8-bit  character  option  clears  the  eighth  data  bit  only. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  parity  checking  enabled. 

/NOPARITY[=ttnn:] 


Disables  parity 
terminal.  Data 
is  not  verified. 


generation  and  checking  for  the  specified 
transmitted  between  the  terminal  and  the  system 


When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  parity  generation  and  checking 
enabled . 


/PASTHRU[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Requests  the  system  to  ignore 
the  original  function  of  special  characters  typed  at  the 
specified  terminal  and,  instead,  pass  them  to  a  program  in  their 
binary  form. 

/PASTHRU  allows  you  to  suppress  standard  operating  system 
responses  to  special  characters  (for  example,  CTRL/C  and  CTRL/O) , 
thereby  controlling  output  to  the  terminal  screen. 

While  /PASTHRU  is  enabled,  the  terminal  does  not  recognize  any 
control  characters,  except  CTRL/S  and  CTRL/Q  if  it  is  set  to 
/TTSYNC,  nor  does  it  respond  to  carriage-return/line-feed 
characters . 


If  your  terminal  does  not  seem  to  be  working  properly,  it  may 
have  been  set  to  /PASTHRU. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  been  set  to  /PASTHRU. 

/NOPASTHRU[=ttnn : ] 


(Full  duplex  terminal  driver  only.)  Requests  the  system  to 
recognize  the  original  function  of  special  characters  typed  at 
the  specified  terminal. 
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When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  not  been  set  to  /PASTHRU. 

/NOPASTHRU  is  the  default. 

/PLCTL[=[high] [ s [ low] [:[frsiz][ :basep]]]] 

(Systems  with  pool  monitoring  support  only.)  Sets  the  pool  limit 
parameters  used  by  the  Pool  Monitor  Task  ( PMT ) .  The  following 
list  defines  the  parameters: 

high 

The  high  pool  limit  in  bytes . 


low 

The  low  pool  limit  in  bytes . 


frsiz 

The  minimum  byte  size  of  the  largest  free  pool  block 
required  for  avoiding  low  pool  actions  by  the  Pool  Monitor 
Task  (PMT. . . ) . 

basep 


The  base  task  priority,  which  is  the  lowest  priority  a 
nonprivileged  task  can  have  and  still  be  eligible  for  memory 
contention  during  times  of  low  pool?  this  priority  remains 
in  effect  until  pool  conditions  improve.  (Note  that  only 
those  tasks  requested  to  run  while  the  system  is  in  a  low 
pool  state  are  affected) . 

The  following  list  defines  the  limits  of  the  parameters: 


84.  <=low  <=high  <=total  size  of  system  pool 
84.  <=frsiz  <=high 
0.  <=basep  <=250. 


The  following 

list 

gives  the  defaults  for  the  parameters: 

high 

1600 

.  bytes 

low 

600. 

bytes 

frsiz 

200. 

bytes 

basep 

51. 

See  Chapter 

13 

for  information  on  determining  values 

parameters . 

When  you  omit  the  parameter  specifications,  VMR  displays  the 
current  parameters  for  the  system. 
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/POOL[=top] 

Increases  the  size  of  the  dynamic  storage  region  (pool), 
top 

The  first  location  in  memory  used  for  partition  allocation. 
You  specify  top  in  units  of  64-byte  blocks,  in  octal  or 
decimal . 

When  you  do  not  specify  top,  VMR  displays  the  virtual 
address  of  the  top  of  the  Executive,  the  size  of  the  longest 
block  of  pool  space  in  words,  the  total  number  of  words  in 
the  pool,  and,  on  RSX-11M-PLUS ,  the  lowest  physical  address 
at  which  a  partition  can  start.  (You  can  use  the  address 
when  calculating  partition  layouts  for  systems  supporting 
kernel  data  space.  If  your  system  is  not  a  kernel  data 
space  system,  this  value  is  always  equal  to  the  virtual 
address  of  the  top  of  pool.)  The  display's  format  is: 

POOL=top :max : total [ :par] 

where  top  is  given  in  units  of  64-byte  blocks,  max  and  total 
are  in  decimal  words,  and  par  is  the  lowest  physical  address 
(32-word  blocks) . 

You  can  also  specify  top  by  using  a  wildcard  (*).  The 
wildcard  directs  VMR  to  supply  the  maximum  amount  of  pool 
possible.  Specify  the  wildcard  as  follows: 

/POOL=* 

If  you  request  more  pool  than  can  be  supplied,  VMR  prints  a 
warning  message  and  supplies  the  maximum  amount  of  pool 
possible . 

/POOLSIZE[=value] 

Increases  the  size  of  the  dynamic  storage  region  (pool).  The 
value  you  specify  indicates  the  total  amount  of  pool  to  be 
allocated . 

If  you  do  not  specify  a  value,  VMR  displays  the  virtual  address 
of  the  top  of  the  Executive,  the  size  of  the  longest  block  of 
pool  space  in  words,  the  total  number  of  words  in  the  pool,  and 
on  RSX-1 1M-PLUS  systems,  the  lowest  physical  address  at  which  a 
partition  can  start  (32-word  blocks). 

The  /POOL  and  /POOLSIZE  keywords  perform  the  same  function. 
/POOL  allows  you  to  specify  the  top  of  pool.  /POOLSIZE  allows 
you  to  specify  the  total  size  of  pool. 

/PRINTER_PORT[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  has  a  printer  port.  The  VT200-series  of 
terminals,  for  example,  has  printer  ports. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  a  printer  port. 
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/NOPRINTER_PORT[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  does  not  have  a  printer  port. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  a  printer  port. 

/PRIV[=ttnn:] 

Sets  the  specified  terminal  to  privileged  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
privileged  terminals  in  the  system. 

/NOPRIV[=ttnn:] 

Sets  the  specified  terminal  to  nonprivileged  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
nonprivileged  terminals  in  the  system. 

/PUB[=ddnn: ] 

Establishes  the  specified  device  as  a  public  device. 

When  you  omit  the  device  specification,  VMR  displays  all  the 

public  devices  in  the  system. 

/NOPUB[=ddnn: ] 

Causes  the  specified  device  to  lose  its  public  status. 

When  you  omit  the  device  specification,  VMR  displays  all  the 

nonpublic  devices  in  the  system. 

/REGIS[=ttnn:] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  supports  the  ReGIS  graphics  set. 

The  VT125  and  the  VT240  terminals  both  support  the  ReGIS  graphics 
set . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  support  the  ReGIS  graphics  set. 

/NOREGIS[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  does  not  support  the  ReGIS  graphics  set. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  support  the  ReGIS  graphics  set. 
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/REMOTE [=ttnn: [speed]] 


Informs  the  system  that  the  specified  terminal  is  connected  to  a 
modem  and  can  be  connected  to  the  system  by  means  of  a  dial-up 
network.  The  terminal  has  a  line  to  the  one  of  the  following 
multiplexers : 

DH11  DLV11 

DHU11  DZ1 1 

DHV11  DZQ11 

DL11  DZV11 


Specifying  speed  establishes  the  initial  speed  (answer  speed)  of 
the  remote  dial-up  line  for  the  specified  terminal.  You  can 
specify  an  answer  speed  only  for  the  following  variable-speed 
multiplexers : 


DH11  DZ11 

DHU11  DZQ11 

DHV11  DZV11 

You  cannot  specify  an  answer  speed  for  a  DL11  or  DLV11 
multiplexer. 

For  the  DH11  multiplexer/  you  can  specify  the  following  speeds: 

0  300 

50  600 

75  1200 

110  1800 
134.5  2400 

150  4800 

200  9600 

EXTA  (user-specified  speed  A) 

EXTB  (user-specified  speed  B) 

For  the  DHU11  and  DHV11  multiplexers,  you  can  specify  the 
following  speeds: 


75 

1800 

10 

2000 

134.5 

2400 

150 

4800 

300 

9600 

600 

19200 

1200 

For  the  DZ11,  DZQ11,  and  DZV11  multiplexers,  you  can  specify  the 
following  speeds: 


50 

1800 

75 

2000 

110 

2400 

134.5 

3600 

150 

4800 

300 

7200 

600 

9600 

1200 
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When  you  omit  the  terminal 
remote  terminals. 

specification,  VMR 

displays 

all 

the 

When  you  omit  the  speed  specification,  the  current 
the  terminal  remains  in  effect. 

setting 

for 

/NOREMOTE [=ttnn  s ] 

Establishes  the  terminal's 
connected  to  a  modem. 

line  as  a  local 

line 

that 

is 

not 

When  you  omit  the  terminal 
local  terminals. 

specification,  VMR 

displays 

all 

the 

/RNDC[=nn] 

Defines  tine  length  of  the  Executive  round— robin  scheduling 
interval  in  ticks. 

The  length  value  (nn)  is  assumed  to  be  octal,  unless  you  place  a 
period  (.)  after  the  value.  The  minimum  value  for  nn  is  0.  See 
the  RSX-11M  System  Generation  and  Installation  Guide  or  the 
RSX-11M-PLUS  System  Generation  and  Installation  Guide  for  more 
information . 

When  you  omit  the  length  specification,  VMR  displays  the  current 
value  for  the  interval. 

/RNDH[=nn] 

Defines  the  highest  priority,  from  1  to  250,  that  will  be 
considered  for  Executive  round-robin  scheduling.  250  is  the 
highest  priority  and  1  is  the  lowest  priority  you  can  assign. 
Therefore,  a  priority  of  200  takes  precedence  over  a  priority  of 
199. 

The  priority  you  enter  is  assumed  to  be  octal  unless  you  place  a 
period  (.)  after  the  number. 

The  priority  you  specify  must  be  higher  than  the  one  specified 
with  the  /RNDL  keyword.  See  the  RSX-11M  System  Generation  and 
Installation  Guide  or  the  RSX-11M-PLUS  System  Generation  and 
Installation  Guide  for  more  information. 

When  you  omit  the  priority  class,  VMR  displays  the  current  value 
for  the  priority. 

/ RNDL[=nn] 

Defines  the  lowest  priority,  from  1  through  250,  that  will  be 
considered  for  Executive  round-robin  scheduling.  250  is  the 
highest  priority  and  1  is  the  lowest  priority  you  can  assign. 
Therefore,  a  priority  of  200  takes  precedence  over  a  priority  of 
199. 

The  priority  you  enter  is  assumed  to  be  octal  unless  you  place  a 
period  (.)  after  the  number. 
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The  priority  class  must  be  lower  than  the  one  specified  with  the 
/RNDH  keyword.  See  the  RSX-11M  System  Generation  and 
Installation  Guide  or  the  RSX-1 1M-PLUS  System  Generation  and 
Installation  Guide  for  more  information. 

When  you  omit  the  priority  class,  VMR  displays  the  current  value 
for  the  priority. 

/RPA[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Enables  the  read-pass-all 
option.  The  terminal  driver  passes  all  characters  input  at  the 
keyboard  to  the  terminal ' s  input  buffer . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  read-pass-all  option 

enabled. 

/NORPA[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Disables  the  read-pass-all 
option.  The  terminal  driver  does  not  pass  special  function 
characters  (for  example,  CTRL/C)  input  at  the  keyboard  to  the 
terminal's  input  buffer. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  read-pass-all  option 

disabled . 

/ SECPOL 

( RSX-1 1 -M-PLUS  systems  only.)  Displays  secondary  pool  use  in  the 
system.  The  display  is  in  the  following  format: 

SECPOL=secf r : secsiz :pctf r 

secfr 

The  number  of  free  blocks  in  secondary  pool  in  units  of 
32 (decimal) -word  blocks. 

secsiz 


The  size  of  secondary  pool  in  units  of  32 (decimal ) -word 
blocks . 


pctfr 

The  percentage  of 

/ SERIAL[ =ttnn : ] 

free  blocks  in 

secondary  pool . 

( RSX-1 1 M-PLUS  systems 

only.)  Causes 

unsolicited  input  from 

the 

specified  terminal 
parallel . 

to  be  processed 

serially,  rather  than 

i  in 
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Usually,  if  you  enter  a  second  command  line  before  the  first 
command  line  has  completed  executing,  the  system  processes  the 
second  command  line  in  parallel  with  the  first-  When  a  terminal 
is  set  to  serial  processing,  however,  the  system  waits  until  the 
first  command  line  is  finished  processing  before  starting  the 
second . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  process  serially. 

The  default  is  /NOSERIAL. 

/NOSERIALC  =ttnn : ] 

( RSX-11M-PLUS  systems  only.)  Causes  unsolicited  input  from  the 
specified  terminal  to  be  processed  in  parallel  rather  than 
serially.  Parallel  processing  means  that  one  or  more  command 
lines  are  processed  at  the  same  time. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  process  in  parallel. 

The  default  is  /NOSERIAL. 

/ SLAVE [ =ttnn : ] 

Establishes  the  specified  terminal  as  one  that  can  enter  data 
only  if  it  is  solicited  by  a  task.  Therefore,  the  specified 
terminal  always  rejects  unsolicited  input  (other  than  CTRL/O, 
CTRL/Q,  and  CTRL/S). 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  currently  classified  as  slaved. 

/NOSLAVE [=ttnn : ] 

Sets  the  specified  terminal  to  nonslaved  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  currently  classified  as  nonslaved. 

/ SOFT[ =ttnn : ] 

(Full-duplex  terminal  driver  only.)  Informs  the  system  that  the 
specified  terminal  can  accept  software-defined  character  sets. 
The  VT200-series  of  terminals  can  accept  these  character  sets. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  accept  software-defined  character  sets. 

/NOSOFT[=ttnn:] 

(Full-duplex  terminal  driver  only. )  Informs  the  system  that  the 
specified  terminal  cannot  accept  software-defined  character  sets. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  accept  software-defined  character  sets. 
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/ SPEED=ttnn : [ recv : xmit ] 

Establishes  the  receive  and  transmit  speed  for  terminals  attached 
to  the  system  through  a  DH11,  DHU11,  DHV11,  DZ11,  DZQ11,  or  DZV11 
variable-speed  multiplexer.  The  values  are  described  as  follows: 

recv 


the  recv  value  is  the  speed  at  which  characters  are  input  to 
the  computer  from  the  terminal. 


xmit 


the  xmit  value  is  the  speed  at  which  characters  are  output 
to  the  terminal  from  the  computer. 


You  must  specify  both  the 
speed.  If  you  do  not 
current  settings . 


recv  and  xmit  values  when  setting  the 
specify  either  value,  VMR  displays  the 


For 


the  DH11  multiplexer,  you  can  specify  the  following  speeds: 


0 

300 

50 

600 

75 

1200 

110 

1800 

134.5 

2400 

150 

4800 

200 

9600 

EXTA  (user-specified  speed  A) 
EXTB  (user-specified  speed  B) 


For  the  DHU11  and  DHV11  multiplexers,  you  can  specify  the 
following  speeds: 


75 

1800 

110 

2000 

134.5 

2400 

150 

4800 

300 

9600 

600 

19200 

1200 

For  the  DZ11,  DZQ11,  and  DZV11  multiplexers,  you  can  specify  the 
following  speeds: 


50 

1800 

75 

2000 

110 

2400 

134.5 

3600 

150 

4800 

300 

7200 

600 

9600 

1200 

have  a  DZ11, 

DZQ11 , 

transmit  speeds  must  be 
not  support  split  speeds. 


or  DZV11  multiplexer,  the  receive  and 
the  same  because  these  multiplexers  do 
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/SUB=mname  :  sname[  :base  :  size] 

(RSX-11M  systems  only.)  Establishes  a  subpartition. 
Subpartitions  can  be  established  only  in  user-controlled  main 
partitions.  The  values  are  described  as  follows: 

mname 

The  1-  to  6-character  main  partition  name.  The  subpartition 
being  defined  becomes  a  subpartition  in  the  named  main 
partition . 

sname 

The  1-  to  6-character  subpartition  name.  The  subpartition 
being  defined  becomes  a  subpartition  of  the  main  partition 
specified  in  mname. 


base 

The  physical  base  address  of  the  subpartition,  specified  as 
a  number  of  64-byte  blocks. 

size 

The  size  of  the  subpartition,  specified  as  a  number  of 
64-byte  blocks . 

Base  and  size  may  be  entered  in  any  of  the  following  formats; 
nnnn  is  a  number  to  which  the  system  applies  a  multiplication 
factor  to  determine  the  value  used. 


Format  Calculated  Value 

n  Octal  (nnnn*100) 

n.  Decimal  (nnnn. *64.) 

nK  Octal  K  (nnn*4000) 

n.K  Decimal  K  (nnn.*2048.) 


for  calculated  values  are 


Valid  ranges 

Octal 
Decimal 
Octal  K 
Decimal  K 


0<=base<10000 
0 . <=base<4096 . 
0K<=base<200K 
0 . K<=base<2047 .K 


0<size<2000 
0 . <size<1024 . 
0K<size<40K 
0 .K<size<32 .K 


Example : 

Any  of  the  following  designations  for  size  will  allocate  a 
2048 ( decimal ) -byte  subpartition : 


40 

32. 

IK 

l.K 


If  base  and  size  are  omitted,  VMR  displays  the  current  values  for 
the  named  subpartition. 
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/NOSUB=mname : sname 

(RSX-11M  systems  only.)  Eliminates  the  specified  subpartition 
from  the  main  partition. 

/ SWPC[=nn] 

Defines  the  number  of  clock  ticks  for  a  single  Executive  swapping 
interval . 

The  number  of  clock  ticks  (nn)  is  in  the  range  0  to 
45 , 568 ( decimal ) .  The  number  of  clock  ticks  is  assumed  to  be 
octal  unless  you  place  a  period  (.)  after  the  number. 

See  the  RSX-11M  System  Generation  and  Installation  Guide  or  the 
RSX-11M-PLUS  System  Generation  and  Installation  Guide  for  more 
information. 

When  you  omit  the  clock  ticks  specification,  VMR  displays  the 
current  value  for  the  interval. 

/SWPR[=nn] 

Defines  a  priority  range  for  Executive  swapping. 

The  priority  number  (nn)  is  in  the  range  0  through  127.  127  is 

the  highest  priority  and  0  is  the  lowest  priority  you  can  assign. 
Therefore,  a  priority  of  100  takes  precedence  over  a  priority  of 
99. 


The  priority  you  enter  is  assumed  to  be  octal  unless  you  place  a 
period  (.)  after  the  priority  number. 

The  value  for  the  /SWPR  keyword  affects  the  installed  priority  of 
all  tasks.  Each  task  is  initiated  at  its  installed  priority, 
plus  the  value  for  nn  as  assigned  in  /SWPR=nn  (priority  +  nn) . 
While  the  task  is  executing,  its  priority  is  decremented  until  it 
becomes  the  installed  priority  minus  the  value  for  nn  (priority 
-  nn) .  When  the  priority  reaches  this  lower  limit,  the  task  is 
swapped  out  so  that  another  task  with  a  higher  priority  can 
execute.  The  priority  for  the  new  task  changes  in  the  same  way. 
See  the  RSX-11M  System  Generation  and  Installation  Guide  or  the 
RSX-1 1M-PLUS  System  Generation  and  Installation  Guide  for  more 
information . 

When  you  omit  the  range  specification,  VMR  displays  the  current 
value  for  the  priority  range. 

/SYSUICOHuic]] 

Establishes  the  UIC  for  the  system  and  all  system  tasks.  The  UIC 
has  the  format  [g,m],  where  g  and  m  are  octal  numbers  that 
represent  a  group  and  member  number,  respectively. 

On  most  unmapped  systems,  the  system  UIC  is  [1,50].  On  most 
mapped  systems,  the  system  UIC  is  [1,54]. 
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The  UIC  specified  with  the  /SYSUIC  keyword  also  becomes  the 
default  UIC  used  by  the  LOAD  command  and  the  install-run-remove 
option  of  the  MCR  RUN  command . 

When  you  omit  the  UIC  specification,  VMR  displays  the  current 
system  UIC. 


/TERM=ttnn: [type] 


(Full-duplex  terminal  driver  only.)  Establishes  the  terminal  type 
of  the  specified  terminal.  When  VMR  sets  the  terminal  type,  it 
automatically  sets  the  HFILL ,  VFILL ,  CRT,  FORMFEED,  and  HHT 
characteristics  for  the  terminal.  The  standard  terminal  types 
are  as  follows: 


ASR33 

LA34 

ASR35 

LA36 

DTC01 

LA38 

KSR33 

LA50 

LA12 

LA100 

LA30S 

LAI  20 

LA30P 

LA180S 

LA210 

VT52 

LN03 

VT55 

LQP02 

VT61 

LQP03 

VT100 

PC3XX 

VT101 

VT05B 

VT102 

VT50 

VT105 

VT125 

VT131 

VT132 

VT2XX 


If  you  specify  a  terminal  type  that  is  unknown  to  VMR,  VMR  does 
not  set  any  device  characteristics  for  the  terminal.  However, 
VMR  stores  the  value  you  have  specified  in  the  Unit  Control 
Block  (UCB). 


When  you  omit  the  type  parameter,  VMR  displays  the  terminal  type 
of  the  specified  terminal. 


VMR  also  accepts  an  alternate  form  of  the  command.  You  can 
specify  the  terminal  type  and  equate  it  to  the  desired  terminal. 
This  automatically  associates  certain  characteristics  of  the 
particular  terminal  type  with  the  specified  terminal.  (See  the 
RSX-11M/M-PLUS  I/O  Drivers  Reference  Manual  for  a  list  of  the 
implicit  characteristics  for  each  terminal  type.)  The  command  is 
in  the  format : 

SET  /term-type=ttnn : 

where  term- type  is  one  of  the  standard  terminal  types .  Note  that 
the  terminal  types  are  mutually  exclusive. 

The  half-duplex  terminal  driver  also  accepts  the  /term- type  form 
of  the  command.  However,  the  only  legal  terminal  types  for  the 
half-duplex  driver  are  /ASR33 ,  /LA30S,  and  /VT05B.  The  command 
associates  implicit  characteristics  of  the  terminal  type  with  the 
specified  terminal,  but,  unlike  the  full-duplex  terminal  driver, 
the  types  are  not  mutually  exclusive. 

The  following  list  describes  the  effects  of  the  keywords  for  the 
half-duplex  terminal  driver: 

/ASR33  Converts  lowercase  letters  to  uppercase  before 
they  are  output  to  the  terminal. 
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/LA30S  Indicates  that  fill  characters  are  used  after  a 
carriage  return.  The  number  of  fill  characters 
used  depends  on  the  current  carriage  position  at 
the  time  the  carriage  return  occurs . 

/VT05B  Sets  a  vertical  fill  of  three  nulls  after  a  line 

feed  on  60  Hz  systems  and  of  four  nulls  on  50  Hz 
systems . 

/T0P=pname : value 

Directs  VMR  to  move  the  top  boundary  of  the  specified  partition 
up  or  down  the  amount  indicated  by  the  value  parameter. 

The  /TOP  keyword  modifies  the  top  boundary  of  a  system-controlled 
partition  even  if  the  partition  has  tasks  installed  in  it.  If 
you  modify  the  partition  so  that  it  becomes  too  small  to  hold  the 
tasks  installed  in  it,  VMR  displays  a  warning  message  but 
modifies  the  partition  anyway. 

pname 


The  1-  to  6-character  alphanumeric  partition  name. 

value 


The  number  of  64-byte  blocks . 

The  value  can  be  supplied  in  five  formats:  +value,  -value, 
value,  +*  or  *,  and  -*.  These  are  described  as  follows: 

+value 

Moves  the  partition's  top  boundary  up  by  the  specified 
amount.  Moving  the  partition's  top  boundary  up  makes 
the  partition  larger. 


NOTE 

You  must  supply  the  value  in  the  same  units  as 
the  base  and  size  parameters  for  the  /PAR 
keyword . 


-value 

Moves  the  partition's  top  boundary  down  by  the 
specified  amount.  Moving  the  partition's  top  boundary 
down  makes  the  partition  smaller. 

value 


Moves  the  partition's  top  boundary  until  the 
Partition  s  total  size  is  equal  to  the  specified  value. 

+  *  or  * 

Moves  the  partition's  top  boundary  up  as  far  as 
possible.  The  most  the  top  boundary  can  move  up  is  to 
the  bottom  boundary  of  the  partition  above  it,  or,  to 
the  top  of  memory,  if  the  partition  is  the  last 
partition  in  memory. 
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_  * 


Moves  the  partition's  top  boundary  down  as  far  as 
possible.  The  most  the  top  boundary  can  move  down  is 
to  the  top  of  the  of  the  first  fixed  task,  common,  or 
driver  in  the  partition  at  the  time  the  /TOP  keyword  is 
executed.  If  nothing  is  loaded  into  the  partition,  the 
partition  assumes  a  size  of  one  64-byte  block. 


/TTSYNC[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Enables  the  terminal 
synchronization  option  for  the  specified  terminal.  This  means 
that  the  system  responds  to  the  CTRL/S  and  CTRL/Q  characters  used 
to  control  the  flow  of  information  on  the  terminal  screen,  when 
you  type  them  on  the  terminal.  /TTSYNC  is  the  default. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  terminal  synchronization. 

/NOTTSYNC[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Disables  the  terminal 
synchronization  option  for  the  specified  terminal.  The  system 
will  not  respond  to  the  CTRL/S  and  CTRL/Q  characters  when  you 
type  them  on  the  terminal. 

Note  that  if  you  set  your  terminal  to  /NOTTSYNC,  the  NO  SCROLL 
key  on  VTlOO-series  terminals  and  the  HOLD  SCREEN  key  on 
VT200-series  terminals,  will  no  longer  work. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  terminal  synchronization. 

/TYPEAHEAD[=ttnn: [size]] 

(Full-duplex  terminal  driver  only.)  Enables  the  typeahead  option 
for  the  specified  terminal. 

The  terminal  driver  stores  input  characters  in  the  typeahead 
buffer  before  passing  them  to  the  task.  When  the  typeahead 
option  is  enabled,  characters  input  during  periods  between 
requests  are  not  lost. 

If  size  is  specified  ( RSX-11M-PLUS  systems  that  support  kernel 
data  space  only),  the  typeahead  buffer  size  is  set  accordingly. 
The  value  for  size  can  be  from  0  through  255 (decimal ) .  If  you 
specify  0  or  1,  the  terminal  will  not  have  the  typeahead  option 
enabled  (same  effect  as  /NOTYPE AHEAD ) .  The  default  for  size  is 
86 (decimal) . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  typeahead  option  enabled. 
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/NOTYPEAHEAD[=ttnn: ] 

(Fuii-dupiex  terminal  driver  only.)  Disables  the  typeahead  option 
,  e  sPecif led  terminal.  The  terminal  driver  does  not  store 

iS  forcedSto°lPreVent  the±r  1038  because  the  si2e  of  the  buffer 

t^rmin^  terminal  specification,  VMR  displays 

terminals  that  do  not  have  the  typeahead  option  enabled. 

/UIC=[ [uic] : ]ttnn : 


all  the 


Establishes  the  specified  UIC  as  the  default  UIC  for  the 
specified  terminal  (the  default  is  TI:).  All  tasks  run  from  the 
terminal  are  run  with  the  UIC  of  the  terminal,  except  ?n  a 
multiuser  protection  system.  in  such  a  system,  a  privileged  user 

coLand!  6  the  terminal  UIC  with  the  /UIC  keyword  of  ?he  RUN 

External  MCR  function  tasks  are  requested  with  the  /UIC  keyword. 
These  tasks  are  the  MOUNT,  INSTALL,  DMO,  and  UFD  commands  (which 
execute  as  tasks),  and  all  system-supplied  software. 

When  you  specify  only  the  terminal,  VMR  displays  the  UIC  for  that 
s  rm  1  n  3.  _l  • 

/VFILL[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Enables  the  vertical  fill 
characters  option  for  the  specified  terminal.  The  terminal 
driver  adds  four  fill  characters  following  each  line  feed. 


When  you  omit  the  terminal  specification,  VMR  displays  all 
terminals  on  the  system  that  have  the  VFILL  option  enabled. 

/NOVFILLOttnn:] 


the 


(Full-duplex  terminal  driver  only.)  Disables  the  vertical  fill 
characters  option  for  the  specified  terminal.  The  terminal 
feed^  dOSS  ^  ^  anY  Vertical  fil1  characters  following  line 


When  you  omit  the  terminal  specification,  VMR  displays  all  the 
enlbied  °“  SyStSm  ^  d°  n0t  haVS  tbe  yFILL  °Ption 

/WCHK[=ddnn:] 

f°r  a?4  Filfs-ll  devices,  except  DX:,  DY: ,  and  magnetic 
tapes,  that  all  write  operations  are  to  be  followed  bv  a 

aSSU"  the  rellabillty  =«  transfers 

On  RSX-11M,  Executive  support  for  write-checking  is  a  system 
generation  option  and  must  be  selected  for  this  command  to  ha^I 

always ^included?  RSX-11M-PLUS '  for  write-checking  is 
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When  you  omit  the  device  specification,  VMR  displays  all  Files  11 
disk  drives  with  write-checking  enabled. 

/NOWCHK[=ddnn: ] 

Specifies  that  write-checking  is  to  be  disabled  for  the  specified 
device . 

When  you  omit  the  device  specification,  VMR  displays  all  disks 
that  support  write-checking  but  have  the  option  disabled. 

/WRAP[=ttnn: ] 

(Full-duplex  terminal  driver  only.)  Enables  the  wraparound  option 
for  the  specified  terminal.  The  terminal  driver  automatically 
generates  a  carriage  return/line  feed  sequence  when  the  number  of 
input  characters  exceeds  the  buffer  size  of  the  specified 
terminal .  Both  the  carriage  return  and  line  feed  are  transparent 
and  do  not  appear  in  the  input  buffer. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  wraparound  option  enabled. 

/NOWRAP [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Disables  the  wraparound 
option  for  the  specified  terminal.  The  terminal  driver  does  not 
accept  input  characters  beyond  the  input  buffer  size  for 
terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  wraparound  option  disabled. 


Notes  on  Memory  Allocation  Keywords 
1 . 


If  a  command  attempts  to  eliminate  a  partition  in  which  tasks 
are  installed  or  drivers  loaded,  VMR  rejects  the  command 
until  the  tasks  have  been  removed. 

2.  When  you  define  a  partition,  the  name  must  not  already  be 
defined  as  a  partition.  In  addition,  a  partition  cannot 
overlap  any  other  partition. 

On  RSX-11M,  subpartitions  can  overlap  other  subpartitions. 

3.  The  address  specified  with  the  /POOL  keyword  must  be  lower 
than  the  base  address  of  the  first  partition  in  the  system. 

On  RSX-11M,  an  exception  is  the  partition  LDRPAR  for  a 
resident  loader.  LDRPAR  is  in  the  Executive. 

4.  Once  you  have  allocated  space  to  the  dynamic  storage  region 
(pool),  you  cannot  recover  the  space  for  use  in  partitions. 

5.  When  the  highest  memory  addresses  of  a  system  are  allocated, 
the  size  of  the  partition  is  modified  automatically  to 
reflect  the  amount  of  memory  present  when  the  system  is 
bootstrapped . 
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6.  On  RSX-1 1M-PLUS ,  SET  /TOP  and  SET  /BOT 
secondary  pool  partitions . 


can  be  used  for 


act  — r  ~  luciu^j.  y  ui  trie  naraware  in 


in  use. 


Examples 


1.  VMR>SET  /ABAUD=TT4 J 

Enables  the  autobaud  detection  option  for  TT4:. 

2.  VMR>SET  / A B A U D 
ABAUn=TT2 J 
ABAIJD  =  TT4 t 
ABAUD=TT5 ♦ 

Displays  all  the  terminals  that  have  the  autobaud  detection 
option  enabled. 

3.  VMR > SET  /AV0=TT22  J 

Informs  the  system  that  the  VT100  terminal  TT22 :  has  the 

advanced  video  option. 

4.  VMR > SET  /BLKM0D=TT3J 

Enables  local  editing  and  block-mode  transmission  for  the 
terminal  TT3 : . 

5.  V M R > S E T  /BRQ-TT5  J 

Enables  the  broadcast  option  for  TT5 : . 

6.  VMR>SET  /BRO 
BR0*TT2t 
BR0=TT4  * 

B  R  0  =  T  T  5  J 


Displays  all  the  terminals  that  have  the  broadcast  option 


7.  VMR> SET  /BUF  =  LPOJ 
BtJF-LPO  *  132  * 

Displays  the  current  buffer  size  of  LPO:. 

8.  VMR> SFT  /BUF  =  TT 1 } 40 ♦ 

Sets  the  buffer  size  of  TT1 :  to  40 (decimal). 

9.  V M R >  SET  /CRT  =  TT3  J 

Enables  the  backwards  deletion  option  on  the  display  terminal 
whose  number  is  TT3 : . 
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10.  VMR>SET  /CRT 
CRT=TT3i 
CRT  =  TT7  * 

CRT=TT12  * 

Displays  all  the  terminals  that  have  the  backwards  deletion 
option  enabled. 

11.  VMR>SET  /N0DEC=TT10J 

Informs  the  system  that  terminal  TT10:  is  not 

upward- compatible  with  the  VTlOO-series  of  terminals. 

12.  VMR>SET  /ED  I T  =  TT25  * 

Informs  the  system  that  terminal  TT25 :  can  perform 

ANSI-defined  advanced  editing  functions. 

13.  VMS>SET  /ESCSEQ=TT35 

Establishes  terminal  TT3 :  as  a  terminal  that  can  send  and 
receive  escape  sequences. 

14.  VMR>SET  /F.SCSEQ 
ESCSEQ=TT3 ♦ 

ESCSEQ~TT7 ♦ 

E8C8EQ-TT 16  ♦ 

Displays  all  the  terminals  that  can  send  and  receive  escape 
sequences . 

15.  VMR>SET  /N0ESCSEQ=TT3t 

Disables  support  of  escape  sequences  for  TT3 : . 

16.  VMR>SET  /HSYNC=TT22 * 

Enables  host-terminal  synchronization  for  terminal  TT22:. 

17.  VMR>SET  /I..A30S  "TT2  { 

VMR>SET  ./LA30S 
LA30S  =  TT 0  ♦ 

LA30S=TT2*. 


Sets  TT2:  as  an  LA30S,  then  displays  all  the  LA30S 

terminals . 

18.  VMR>SET  /NETUIC 
NETLil  C  =  r.20 » 31 

Displays  the  current  network  UIC . 

19.  VMR>SET  /NETUTC=C25f 63 

Sets  the  network  UIC  to  [25,6]. 

20.  VMR>SET  /0F'T  =  DM1 1  NEAR 

Enables  I/O  queue  optimization  for  DM1:,  using  the  NEAR 
algorithm. 
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21.  VMR>SET  /DPT 

opt=dbo:near 

0PT=DB1 *  NEAR 

opt=dmo:near 

0PT=0M1 *  NEAR 


Displays  all  the  disk  devices 
optimization  enabled. 

22.  VMR>SFT  /PARITY=TT15 : EDEN 


that  have  i/o 


queue 


Enables  parity  generation  and  checking  for  terminal  TT15 : 
and  informs  the  system  that  if  an  even  number  of  bits  are 
counted  during  data  transmission,  the  transmission  of  data 
does  not  return  an  error. 

23.  VMR>SET  /PASTHRIJ  =  TT22 } 


l*^fo^ros  the  system  that  it  should  ignore 
typed  at  terminal  TT22:  and  pass  them  to 
binary  form. 


special  characters 
a  program  in  their 


24.  VMR>SET  /PL..CTL 

PLCTL=1600 • *  600 . :200. J51 . 


Displays  the  current  pool  limit  parameters  used  by  the  Pool 
Monitor  Task. 


25.  VMR>SET  /PR I NTER_P0RT=TT22 5 

Informs  the  system  that  TT22:  has  a  printer  port. 

26.  VMR>SET  /PRIM=TT0J 


Sets  TTO:  to  be  a  privileged  terminal. 

27.  VMR>SET  /PRiy 
PRiy=TT0: 

P  R I V  =  T  T 1 J 


Displays  all  privileged  terminals. 
28.  UMR>SET  /RERIS=TT15: 


^n£°fms  the  system  that  the  terminal  TT15:  supports  the 

ReGIS  graphic  set. 

29.  VMR>SFT  /REM0TE=TT21 * 


Sets  the  terminal  line  corresponding  to  TT21 : 
dial-up  line. 


as  a  remote 


30.  y M R >S E T  /REMOTE 
REM0TE=TT 1 : 
REM0TE  =  TT2  * 
REM0TE=TT3  5 
REMOTE =TT4t 
REMOTE =TT21 J 


Displays  all  the  terminals  that  are  currently  set  as 
dial-up  lines. 


remote 
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31.  VMR>SET  /RNDC 

RNDC=6. 

Displays  the  current  length  of  the  round-robin  scheduling 
interval • 

32.  VMR>SET  /RNDC=10. 

Sets  the  length  of  the  round-robin  scheduling  interval  to 
lO(decimal)  ticks. 

33.  VMR>SET  /SECPOL. 

SECP0L=285.  J440 J44% 

Displays  the  amount  of  secondary  pool  currently  being  used. 

34.  VMR>SET  /SL  AVE  =  TT3  J 

Sets  TT3 :  to  be  a  slaved  terminal . 

35.  VMR>SET  /S0FT=TT22J 

Informs  the  system  that  terminal  TT22s  accepts 

software-defined  character  sets. 

36.  VMR>8ET  /SWPR 
SWPR=5. 

Displays  the  current  value  for  the  Executive  swapping 
priority  range. 

37.  VMR>SET  /SWPR-iO. 

Sets  the  Executive  swapping  priority  range  to  lO(decimal). 

38.  VMR>SET  /TERM=TT25 5 
Term=TT25t  VTIOO 

Displays  the  terminal  type  of  terminal  TT25:. 

39.  VMR>SET  /TERM=TT25 : VT2XX 

Requests  the  system  to  give  terminal  TT25:  the  same 

capabilities  as  a  VT200-series  terminal. 

40.  VMR>SF.T  /TTSYNC  =  TT22 5 

Enables  terminal  synchronization  for  TT22: 

41.  VHR>8ET  / VT05B 
0T 05B  =  TT 4  t 
VT05B=TT5  J 
VT05R=TT 6 ♦ 

Displays  all  VT05B  terminals. 

42.  VMR>SET  /WCHK*DK1J 

Enables  write-checking  on  DK1 s . 
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43.  VMR> SET  /PAR  =  SYSPAR 5 420 :  1 40 5  SYS 

Defines  a  partition  called  SYSPAR  whose  base  address  is 
42000 (octal)  and  whose  length  is  14000 (octal)  bytes. 

44.  V  H  R >  SET  /N0PAR=SYSPAR 

Eliminates  the  main  partition  SYSPAR. 

45.  VMR>  SFT  /P AR  =  GEN : * 5 * 

Creates  a  partition  named  GEN,  setting  the  base  address  as 
low  as  possible  and  making  the  partition  as  large  as 
possible . 

46.  0MR>SET  /P00l.  =  420 

Establishes  the  top  of  the  dynamic  storage  region  (pool). 
Following  this  command,  no  user-defined  partition  can  beqin 
below  42000 (octal ) . 

47.  VHR5SET  /POOL 

POOL.  =  1200  5 11  470.  :  11738.  :2003 


Shows  that  the  last  virtual  address  in  the  Executive  is 
120000,  the  longest  free  block  is  11470 (decimal) -words,  and 
the  total  of  all  pool  space  is  11738 (decimal ) -words .  The 
lowest  physical  address  at  which  a  partition  can  start  is 
2003  (32-word  blocks). 
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TASKLIST 

Use  the  TASKLIST  command  to  display  a  description  of  each  installed 
task  in  the  system.  The  display  contains  several  columns  that  give, 
from  left  .xp  TASKLIST  command  (VMR) display  contents  to  right,  the 
following  information: 

•  Task  name 

•  Task  version  identification 

•  Task  Control  Block  address 

•  Partition  name 

•  Task  priority 

•  Size  of  task  in  bytes  (in  octal) 

•  Load  device  identification 

•  Disk  address  logical  block  number  (in  octal)  on  unsaved 

systems ,  or  the  image  or  task  file  identification  on  saved 

systems 

•  Task  memory  state  (saved  systems  only) 

On  RSX-1 1M-PLUS ,  the  display  lists  the  tasks  installed  in  primary  pool 
and  then  the  tasks  installed  in  secondary  pool.  The  tasks  in 
secondary  pool  are  indicated  by  a  plus  sign  (+)  . 

Format 

TASCKLIST] [ taskname] 

Parameter 

taskname 

The  name  of  a  single  installed  task,  whose  description  you  want 
displayed . 

Examples 


The  following 

example 

is  from 

an  unsaved 

system: 

vmr>tas 

TKTN 

03.14 

035300 

GEN 

248.  010000 

LB0J-00631420 

♦  .  ♦  MCR 

01.01 

035174 

GEN 

160.  040000 

LB0.-00630300 

MCR ♦ ♦ ♦ 

3.3 

035070 

GEN 

160.  010000 

L  B0  ♦ -0^627721 

♦  ♦  .INS 

4 

035614 

GEN 

100.  040000 

LB0.-00627333 

♦  ♦  .LOA 

03.3 

035510 

GEN 

50.  040000 

L.B0.-00627643 

♦  * ♦ UNL 
0MR> 

03.4 

035404 

GEN 

50.  040000 

LB0 ♦ -0007051 2 

On  a  system  image  generated  for  a  22-bit  system  with  more 
than  124K-words  of  memory,  the  size  field  (sixth  column) 
contains  8-digit  rather  than  6-digit  numbers. 
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2. 


The  following 

example 

is  from 

a  saved  system: 

V  M  R  >  T  A  S 

LDR ♦ ♦ «  08*03 

034210 

L.DRPAR 

248* 

00003000 

LBO  :  ~ 

FIL.E 

ID 

J  ( 1 1 1  1  , 

12)  FIXED 

TKTN 

03.14 

115424 

GEN 

248* 

00010000 

LB0  J  - 

FILE 

ID 

J (31540 

,27) 

MTAACP 

0010 

115214 

GEN 

200* 

00013500 

l..bo:- 

FILE 

ID 

:  (31461 

,24) 

MCR  *  *  * 

3*3 

116464 

SYSPAR 

160* 

00010000 

L  B  0  ♦  - 

FILE 

ID 

: (31454 

,12) 

♦  *  *  DCL. 

0 1 1 3  A 

1 15634 

GFN 

160* 

00040000 

l.BO  J- 

FILE- 

ID 

: (31344 

,53) 

DCL *  *  * 

0 .1. 1 3  A 

115530 

GEN 

160* 

00010000 

lbo:- 

FILE 

ID 

: (31345 

,5) 

♦ ♦ ♦ MCR 

01*01 

036770 

GEN 

160* 

00040000 

lbo:- 

FILE 

ID 

: (30546 

,34) 

♦  * ♦ MOD 

23*00 

036250 

GEN 

160* 

00040000 

LB0  *  - 

FILE 

ID 

♦♦  (5424, 

15) 

F11ACP 

M0320 

117674 

GEN 

149* 

00065700 

l.bo:- 

FILE 

ID 

* (30101 

,47) 

DB00F1 

M0320 

117570 

GEN 

149* 

00065700 

LB0  ♦  ~ 

FILE 

ID 

t  (31,370 

,6) 

COT*  *  * 

X00.01 

117360 

GEN 

145* 

00015400 

L.BO  *  - 

FILE 

ID 

*♦  (31336 

,120) 

*  * ♦ DM0 

23*00 

117254 

GEN 

140* 

00040000 

L  B  0  J  - 

FILE 

ID 

: (31346 

,23) 

*  *  *  INI 

20*01 

116674 

GEN 

140* 

00040000 

LB01- 

FILE 

ID 

: (31424 

,?5) 

*  * ♦ UFO 

V0410 

116044 

GEN 

140* 

00040000 

l.bo:~ 

FILE 

ID 

:  (31541 

,34) 

F'MD*  ♦  ♦ 

3*1 

114630 

GEN 

140* 

00023600 

lbo:- 

FILE 

ID 

: (31464 

,70) 

HRC *  *  * 

01*01 

036560 

GEN 

140* 

00050400 

LB0  *  - 

FILE 

ID 

: (31240 

,21 ) 

SHF*  *  * 

03*01 

115320 

SYSPAR 

105* 

00010000 

l.bo:- 

FILE 

ID 

: (31521 

,40) 

FXR  *  * ♦ 

01 

117104 

GEN 

100* 

00003100 

lbo:~ 

FILE 

ID 

: (31371 

,113) 

♦  ♦  ♦  INS 

4 

116570 

GEN 

100* 

00027700 

LB0  J- 

FILE 

ID 

:  (31435 

,12) 

♦  *  ♦  S  A  V 

04.35 

116254 

TSTPAR 

100* 

00040000 

LBOJ- 

FILE 

ID 

:  (31475 

,5) 

SAVTO 

04*35 

036130 

TSTPAR 

100* 

00040000 

lbo:- 

FILE 

ID 

:  (31475 

,5) 

♦  *  ♦  P  R  V 

4*30 

036664 

GEN 

100* 

00040000 

L  B  0  :  - 

FILE 

ID 

* (3433, 

163) 

♦♦♦AT* 

04*25 

037254 

GFN 

65* 

00057700 

L.B0J- 

FILE 

ID 

J (31421 

,131) 

♦  ♦  ♦  BOO 

04*08 

117464 

GEN 

50* 

00040000 

L  B  0  J  ~ 

FILE 

ID 

J (31323 

,6) 

♦  ♦  ♦  ACS 

01.1 

1 15740 

GEN 

50* 

00040000 

L  B0  :  - 

FILE 

ID 

t (31321 

,73) 

♦  ♦  ♦ HEL 

01*25 

037360 

GEN 

50* 

00044100 

I...B0J- 

FILE 

ID 

t (31416 

,15) 

VMR> 


The  display  for  a  saved  system  differs  from  the  display  for  a 
unsaved  system  in  that  the  file-ID  of  the  task  file,  rather 
than  the  logical  block  number,  is  displayed.  FIXED  indicates 
that  the  task  is  fixed  in  memory. 

3.  The  following  example  is  from  an  RSX-11M-PLUS  saved  system 
that  has  tasks  installed  in  secondary  pool: 


BAPO 

02 

113440 

QMG ♦ ♦ ♦ 

1*7 

112450 

LPO 

1.9 

112734 

LP1 

1*9 

112604 

SHC*  * ♦ 

01*01 

110600 

SHUTUP 

02 

110320 

.  ♦ ♦ DM0 

2.3*20 

006025+ 

♦ ♦ ♦ MCR 

2*4 

006037+ 

♦ ♦ ♦ MOU 

2502. 

006041+ 

♦  *  *DCL 

00 

006130+ 

VMR  > 


GEN 

80* 

00045700  lbo:- 

FILE 

id: 

(4332,27) 

GEN 

75* 

00031400  L.B0J- 

FILE 

id: 

(4366,2) 

GEN 

70* 

0001*5400  LB0:~ 

FILE 

id: 

(4354,135) 

GEN 

70* 

00015400  LBO  *  - 

FILE 

id: 

(4354,135) 

GEN 

60* 

00051.700  L.B0J- 

FILE 

id: 

(4360,2) 

GEN 

50* 

00011200  LBO  *  - 

FILE 

id: 

(4320,65) 

GEN 

160* 

00015500  LBOJ- 

FIL.E 

id: 

(4167,35) 

GEN 

160* 

00032000  LBO  *  - 

FILE 

id: 

(2132,227) 

GEN 

1  60* 

00040000  L.B0J- 

FILE- 

id: 

(4205,13) 

GEN 

160* 

00035600  LBO*- 

FILE 

id: 

(2535,1525) 
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Use  the  TIME  command  to  set  the  date  and  time  or  to  display  the 
and  time.  The  TIME  command  has  two  formats. 

Format  1 

TIM[E]  [hrs :mins[ : secs]]  [ml/day/year] 

Format  2 

TIM[E]  [hrs :mins[ : secs] ]  [day-m2-year ] 

Parameters 

hrs 


Hours  (range  0  through  23). 


mins 


Minutes  (range  0  through  59). 

secs 

Seconds  (range  0  through  59).  This  parameter  is  optional; 
default  is  zero. 

ml 

Numeric  representation  of  month  (range  1  through  12). 


m2 


Three-letter  abbreviation  for  month. 


day 


Day  (range  1  through  31). 


year 


Year  (range  0  through  99).  The  year  is  relative  to 
therefore,  1986  is  entered  as  86. 

Examples 

1.  vmr>tim 

10 J 23t 31  21-JUN-85 

Displays  the  current  system  image  time  and  date. 

2.  UMR>TIM  14J30  6/24/85 

Sets  the  time  to  14:30:00  and  the  date  to  24-JUN-85 . 


date 


the 


1900; 
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Notes 


1*  You  can  specify  the  time  and  date  in  any  order. 

2.  If  you  specify  the  time  and  the  date,  VMR  sets  the  system 
image  clock  and  calendar. 

3.  If  you  specify  the  time  but  not  the  date,  VMR  only  sets  the 
clock. 


4.  If  you  specify  the  date  but  not  the  time,  VMR  only  sets  the 
calendar . 


5.  If  you  don't  specify  a  time  or  date,  VMR  displays  the  current 
system  image  time  and  date. 

6.  The  form  used  to  specify  the  date  does  not  affect  the  display 
format.  The  date  is  always  displayed  as  day-month-year. 

7.  All  numeric  values  are  decimal.  No  terminating  period  (.)  is 
required. 
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UNFIX 


Use  the  UNFIX  command 
the  system  image . 
command . 


to  free  a  fixed  task  from  the  virtual  memory  of 
The  UNFIX  command  is  the  complement  of  the  FIX 


If  a  fixed  task  exits  or  aborts,  it  still  occupies  the  physical  memory 
in  the  partition. 


Format 

UNF [ IX]  taskname[ /keyword] 
Parameters 


taskname 

The  task  that  you  want  to  unfix  from  memory. 

/keyword 

One  of  the  following  (RSX-11M-PLUS  systems  only): 

/REG 

/RON 

Keywords 

/REG 

Specifies  that  the  task  to  be  unfixed  is  a  common  region. 

/RON 

Specifies  that  the  task  is  a  multiuser  task,  the  read-only 
segment  of  which  is  to  be  unfixed  from  memory. 

Example 

VMR>UNFIX  XKE 

Unfixes  task  XKE,  freeing  the  partition  in  which  it  resides. 
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UNL 


UNLOAD 

Use  the  UNLOAD  command  to  remove  a  loadable  device  driver  from  the 
un?o“ed“a9e-  ”  “  deViCe  ±S  however ,  its  driver 

To  nnioad  a  device  driver  from  the  system  image,  the  driver's  svmbol 

director-0*1  mUSt  reside  on  LB:  under  the  same  directory  al  the 

fl  501  fL°5  hS  SySt®ra  image  file:  The  system  directory  is  usually 
[1,50]  for  an  unmapped  system  and  [1,54]  for  a  mapped  system.  Y 

The  UNLOAD  command  cannot  remove  a  loadable  data  base  from  the  system 
image,  even  if  the  data  base  was  loaded  by  means  of  the  LOAD  command. 

Format 

UNL[OAD]  dd:[/VEC] 

Parameters 


dd: 


A  2  character  ASCII  device  name.  You  must  specify  a  device  name. 

/VEC 

( RSX-11M-PLUS  systems  only.)  Informs  the  system  that  the  driver 
to  be  unloaded  is  vectored.  The  /VEC  keyword  prevents  the 
comparison  of  the  driver  symbol  table  file  and  the  system  symbol 
table  file. 

Example 

[J M R > I J N L  LPJ 

Unloads  the  line  printer  driver  (LPDRV) . 
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10.6  VMR  ERROR  MESSAGES 

This  section  contains  explanations  for  VMR  error  messages.  Error 
messages  can  appear  in  one  of  the  following  formats: 


VMR  —  *DIAG*  message 


This  format  indicates  a  diagnostic  error  message.  A 
error  message  usually  indicates  that  something 
happened,  but  that  the  error  did  not  interfere 
operation . 


diagnostic 
unexpected 
with  VMR ' s 


VMR  —  message 

This  is  an  unmarked  error  message.  An  unmarked  error  message 
usually  indicates  that  VMR  rejected  the  command  line.  If  the 
offending  line  is  in  an  indirect  command  file,  VMR  ignores  the 
rejected  line  and  attempts  to  execute  the  remaining  command 

lines . 

VMR  —  * FATAL*  message 

This  is  a  fatal  error  message.  A  fatal  error  message  indicates 
that  VMR  rejected  the  command  line  and  that  VMR  has  either  exited 
or  reset  itself  to  the  beginning  (that  is,  Enter  filename:).  If 
the  offending  line  is  in  an  indirect  command  file,  VMR  exits 
without  attempting  to  execute  the  remaining  command  lines . 

The  following  explanations  for  error  messages  contain  the  text  of  the 
error  message,  but  not  the  format.  They  are  in  alphabetical  order. 

VMR  —  Access  to  common  block  denied 

Explanation:  You  attempted  to  install  a  task  that  has  specified 

illegal  access  to  a  shared  region. 

VMR  —  Addressing  extensions  not  supported 

Explanation:  You  attempted  to  install  a  task  that  was  built 
using  the  VSECT  (virtual  section)  directive  into  a  system  image 
that  does  not  support  the  VSECT  feature. 

VMR  —  Alignment  error 

Explanation:  The  base  address  or  size  of  the  partition  being 
created  with  the  SET  command  conflicts  with  existing  partitions 
or  physical  memory. 

VMR  —  Base  address  must  be  on  a  4K  boundary 

Explanation:  The  virtual  base  address  of  the  task  being 

installed  is  not  aligned  on  a  4K  boundary. 

VMR  —  Base  mismatch  common  block  <commonname> 

Explanation :  The  base  address  of  the  partition  does  not  match 

that  of  the  common  block. 

VMR  —  Bus  switch  not  loaded 

Explanation:  You  attempted  to  load  a  device  requiring  a  bus  run 

before  you  loaded  the  bus  switch. 
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VMR  —  Cannot  fix  an  i/D  space  task 

Explanation:  You  attempted  to  fix  a  task  that  is  built  with  I- 

and  D-space.  These  tasks  cannot  be  fixed. 

VMR  —  Cannot  fix  a  task  in  a  system  controlled  partition 

Explanations  This  is  a  VMR  restriction.  To  fix  a  task  in  a 
system-controlled  partition,  use  the  MCR  FIX  command  and  then 
save  the  system  image. 

VMR  —  Cannot  have  multiple  pool  or  CPU  partitions 

Explanation:  You  attempted  to  create  a  secondary  pool  partition 

in  a  system  that  already  has  one.  There  can  be  only  one 
secondary  pool  partition  in  a  system. 

VMR  —  Cannot  install  shared  region  with  increment 

Explanation:  You  specified  both  /lNC=size  and  /WB=YES  when 

installing  a  common.  When  a  common  is  installed  with  an 
increment,  it  will  no  longer  fit  in  its  original  task  image  file; 
therefore,  you  cannot  also  specify  that  the  common  be  written 
back  into  its  task  image  file  (/WB=YES). 

VMR  —  Cannot  install  tasks  or  commons  from  other  than  LB: 

Explanation:  SAVE  does  not  allow  saving  of  a  system  that  has 
tasks  and/or  commons  that  were  not  installed  from  the  library 
device  LB:.  Therefore,  a  task  or  common  cannot  be  installed  from 
other  than  LB:. 

VMR  —  Cannot  LOAD/UNLOAD  a  pseudo  device 

Explanation:  When  loading  or  unloading  a  device  driver,  the 
physical  name  of  the  driver  must  be  specified. 

VMR  —  Cannot  UNFIX  a  mapped  common  region 

Explanation:  You  attempted  to  unfix  a  common  region  that  is 

currently  mapped  by  a  task. 

VMR  —  Cannot  UNFIX  the  directive  common 

Explanation:  RSX-11M-PLUS  directive  commons  can  be  removed  but 

not  unfixed.  Because  directive  commons  are  merged  with  DIR11M  as 
they  are  fixed,  the  size  of  a  particular  common  is  unknown. 

VMR  —  Checkpoint  area  too  small 

Explanation:  The  area  allocated  for  checkpointing  in  the  task 

image  file  is  smaller  than  the  partition  into  which  the  task  is 
being  installed.  The  system  image  does  not  support  the  dynamic 
allocation  of  checkpoint  space. 

VMR  —  Checkpoint  space  too  small,  using  checkpoint  file 

Explanation:  This  is  a  warning  message.  The  checkpoint  space 

allocated  in  the  task  image  file  is  too  small  to  hold  the  task 
(usually  because  of  the  /INC  keyvTord)  .  The  system  image  supports 
the  dynamic  allocation  of  checkpoint  space.  It  will  use  the 
checkpoint  file  to  store  the  task  when  it  rolls  it  out  to  disk. 
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VMR  —  Circular  redirect  error 

Explanations  The  attempt  to  redirect  a  device  failed  because  it 
would  result  in  a  circular  device  list. 

VMR  —  Command  I/O  error 

Explanation:  The  system  detected  an  I/O  error  during  a  read  from 

an  indirect  command  file. 

VMR  —  Command  syntax  error  < command- line > 

Explanation:  The  syntax  of  the  command  line  is  incorrect. 

VMR  —  Common  block  currently  installed 

Explanation:  You  attempted  to  install  a  common  block  that  has 

already  been  installed. 

VMR  --  Common  block  is  task  partition  <commonname> 

Explanation:  A  task's  request  for  access  to  a  common  block  has 
been  rejected  because  the  requested  partition  is  a  task 
partition . 

VMR  —  Common  block  not  loaded  <commonname> 

Explanation:  The  common  block  specified  by  VMR  in  the  error 

message  has  been  linked  to  the  task,  but  the  common  block  has  not 
yet  been  installed. 

User  Action:  The  common  block  must  be  installed  before  the  task 
can  be  installed. 

VMR  —  Common  block  occupied 

Explanation:  You  attempted  to  install  a  task  in  a  common  block 

that  was  already  occupied. 

VMR  —  Common  block  parameter  mismatch  <commonname> 

Explanation:  The  parameters  of  the  common  block  named  in  the 
error  message  do  not  match  the  parameters  in  the  label  block  of 
the  task  that  references  the  common  block. 

VMR  —  Common  block  segment  count  error 

Explanation:  You  attempted  to  install  a  resident  library  with 

overlays,  but  the  number  of  overlay  segments  in  the  task  header 
differs  from  the  number  specified  in  the  segment  descriptors. 

VMR  —  CTB  <name>  does  not  exist 

Explanation:  The  Controller  Table  (CTB)  name  that  you  specified 

with  the  LOAD  /CTB  keyword  does  not  exist  in  the  resident  data 
base . 

VMR  —  CTB  name  <name>  is  a  duplicate 

Explanation:  The  loadable  data  base  contains  a  Controller  Table 

with  a  name  that  is  the  same  as  a  CTB  name  in  the  resident  data 
base .  CTB  names  must  be  unique . 
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VMR  —  CTB  <name>  not  supported  by  driver  —  not  loaded 

Explanation:  This  is  a  warning  message.  VMR  displays  this 

message  for  either  of  the  following  reasons: 

1.  The  Driver  Dispatch  Table  in  the  driver  does  not  have  all  the 
Controller  Table  mnemonics  that  the  rest  of  the  data  base 
(that  is ,  DCBs  and  CTBs)  implies  that  it  should  have. 

2.  The  CTB  is  defective.  A  defective  CTB  may  contain  a  wrong 
name  or  it  may  point  at  the  wrong  DCB . 

VMR  Data  space  file  exceeds  available  space  in  system  image 

Explanation:  The  RSX11M.SYS  file  is  not  large  enough  to  contain 

the  data  space  file  DSP11M.TSK. 

VMR  —  DCB  table  for  CTB  <name>  is  full 

Explanation:  LOAD  attempted  to  write  the  address  of  the  Device 

Control  Block  (DCB)  of  the  loadable  data  base  into  the  DCB  table 
of  the  Controller  Table  for  a  multicontroller  device.  There  were 
no  null  entries  in  the  DCB  table.  (See  the  RSX-11M-PLUS  Guide  to 
Writing  an  I/O  Driver . ) 

VMR  —  Device  <ddnn:>  is  attached 

Explanation:  You  attempted  to  unload  a  driver  that  has  one  or 

more  of  its  device  units  attached.  The  first  attached  unit  is 
ddnn:.  You  cannot  unload  a  driver  that  has  device  units 
attached. 

VMR  —  Device  <ddnn:>  is  not  in  system 

Explanation:  VMR  displays  this  message  for  any  of  the  following 

reasons : 

1 .  You  attempted  to  save  an  image  on  a  device  that  does  not 
exist  on  the  host  system. 

2.  You  attempted  to  redirect  I/O  requests  to  a  device  that  does 
not  exist  on  the  host  system. 

3.  You  specified  a  device  in  the  LOAD  command  line  for  which 
there  is  no  data  base.  This  is  caused  by  one  of  two 
conditions : 

a.  The  device  does  not  exist  in  the  system  device  tables. 

b.  You  did  not  declare  the  device  to  be  loadable  and 
therefore  LOAD  cannot  find  a  loadable  data  base  for  it. 

4.  You  specified  a  device  in  the  command  line  that  has  not  been 
defined  in  the  system  image. 

5.  You  specified  a  device  in  the  DEVICES  command  line  that  does 
not  exist  in  the  system  image. 

VMR  —  Device  not  mounted 

Explanation:  You  failed  to  mount  the  device  that  contains  the 

system  image  file. 
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VMR  —  Device  not  redirectable 

Explanations  You  attempted  to  redirect  a  device  that  is  marked 
(in  its  UCB )  as  not  redirectable. 

VMR  —  Device  not  terminal 

Explanations  You  attempted  to  set  terminal  characteristics  for  a 
device  that  is  not  a  terminal. 

VMR  —  Device  not  variable  speed  multiplexer 

Explanations  You  attempted  to  set  the  speed  for  a  terminal  that 
is  not  attached  to  a  DH11 ,  DHU11,  DHV11,  DZll,  DZQ11,  or  DZV11 
multiplexer. 

VMR  —  Directive  common  already  loaded 

Explanations  You  attempted  to  fix  in  the  RSX-11M-PLUS  system 
image  a  directive  common  that  is  already  fixed. 

VMR  —  Directive  common  not  contiguous  to  DIR11M 

Explanations  Directive  commons  must  be  loaded  contiguous  to 
DIR11M . 

VMR  —  Directive  common(s)  not  fixed  in  memory 

Explanations  Not  all  of  the  directive  commons  that  were 
installed  in  the  RSX-11M-PLUS  system  image  have  been  fixed. 

VMR  —  Driver  already  resident 

Explanations  You  attempted  to  load  an  already  loaded  device 
driver  or  one  that  is  permanently  resident  in  the  system  image. 

VMR  —  Driver  built  with  wrong  STB  file 

Explanations  The  symbol  definition  file  for  the  driver  you 
attempted  to  load  or  unload  is  not  compatible  with  the  Executive 
symbol  definition  file  for  the  current  system  image.  This  means 
that  the  driver  has  been  built  for  another  system  and  must  be 
rebuilt  before  you  can  load  it  into  the  current  system. 

VMR  —  Driver  cannot  be  unloaded 

Explanations  You  attempted  to  unload  a  permanently  resident 
driver  (that  is,  a  driver  linked  permanently  to  the  Executive). 

VMR  —  Driver  dispatch  table  is  inconsistent 

Explanations  You  attempted  to  load  a  driver  with  an  illegally 
formatted  driver  dispatch  table .  See  the  RSX-11M  Guide  to 
Writing  an  I/O  Driver  or  the  RSX-11M-PLUS  Guide  to  Writing  an  l7o 
Driver  for  more  information. 

VMR  —  Driver  not  loaded 

Explanations  In  the  UNLOAD  command  line,  you  specified  a  driver 
not  resident  in  memory. 

VMR  —  Driver  requires  running  system  for  LOAD/UNLoad 

Explanations  The  driver  you  requested  has  the  symbols  $ddLOA  or 
$ddUNL  in  its  source.  Support  of  driver  load/unload  calls  can  be 
provided  only  by  the  MCR  LOAD/UNLOAD  commands . 
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VMR  Executive  common  partition  eliminated 

Explanation:  This  is  a  warning  message.  One  of  the  Executive 
common  partitions  has  been  removed.  A  system  generated  with 
Executive  common  support  must  have  both  partitions  installed  to 


VMR  —  Executive  common (s)  not  installed 

Explanation:  This  is  a  warning  message.  For  a  system  generated 

with  Executive  common  support,  you  should  install  one  (or  both) 
of  the  commons  before  you  exit  VMR.  Otherwise,  the  system  is 
unusable. 

VMR  --  Executive  too  large 

Explanation:  The  Executive  is  too  large  to  be  accommodated  in 

the  system  image.  This  message  indicates  that  the  Executive  is 
larger  than  20K.  The  system  is  unusable. 

VMR  External  headers  not  supported 

Explanation:  You  attempted  to  install  a  task  built  with  external 
headers  in  a  system  that  was  not  generated  with  external  header 
support . 

VMR  —  Fast  map  not  supported 

Explanation:  You  attempted  to  install  a  task  with  the  /FMAP=YES 
keyword,  without  having  first  selected  support  for  fast  mapping 
during  system  generation. 

VMR  —  Feature  not  supported  in  system  image 

Explanation:  VMR  displays  this  message  for  any  of  the  following 

reasons: 

1 .  You  attempted  to  create  secondary  pool  in  a  system  that  does 
not  support  it. 

2.  You  attempted  to  set  a  device  public  in  a  system  that  does 
not  support  multiuser  protection. 

3 .  You  attempted  to  enable/ disable  the  broadcast  option  for  a 
terminal,  but  the  system  is  not  a  multiuser/multi-CLI  system. 

VMR  —  File  <name>  has  illegal  format 

Explanation:  The  driver's  symbol  definition  file  contains 

illegal  object  code  or  data. 

VMR  —  File  <name>  has  inconsistent  data 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  fix  a  partition  or  a  task  that  is  logically 
beyond  the  end  of  the  system  image  file. 

2.  The  partition  for  loadable  drivers  is  logically  beyond  the 
end  of  the  system  image  file.  The  system  image  is  probably 
corrupt . 

3 .  The  partition  of  the  common  library  you  are  attempting  to 
load  is  logically  beyond  the  end  of  the  system  image  file. 
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VMR  —  File  <name>  not  a  valid  driver  task  image 

Explanation:  One  of  three  things  has  occurred: 

1.  The  driver's  task  image  has  been  overlaid, 

2.  The  driver  has  a  header. 

3.  The  driver  has  referenced  a  resident  library. 

VMR  —  File  not  contiguous 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  install  a  task  from  a  noncontiguous  file. 
Task  images  must  reside  on  contiguous  files. 

2.  The  file  ddDRV.TSK  is  not  contiguous.  This  file  must  be 

contiguous  for  a  device  driver  to  be  loaded. 

VMR  --  File  not  found 

Explanation:  You  requested  a  file  not  located  in  the  directory 

of  the  volume  you  specified. 

VMR  —  File  not  task  image 

Explanation:  The  data  in  the  label  block  of  the  task  you  tried 

to  install  is  incorrect,  indicating  that  the  file  is  not  a  task 
image . 

VMR  —  Illegal  device/volume 

Explanation:  You  attempted  to  save  your  system  image  on  an 
invalid  device.  Valid  devices  are: 


CT:  Tape  cassette 

DD:  TU58  DECtape  II 

DT:  DECtape 

DU:  RX50  diskette/RA60  disk/RC25  disk  (removable) 

DX:  RX01  diskette 

DY:  RX02  diskette 

MM:  TE/TU16/TU45/TU77  magnetic  tape 

MS:  TS11/TSV05/TU80  magnetic  tape 

MT:  TE/TU10/TS03  magnetic  tape 

MU:  TK50  cartridge  tape/TU81  magnetic  tape 

PP:  Paper  tape 

VMR  —  Illegal  driver  task  APR  usage 

Explanation:  The  device  driver  being  loaded  must  be  built  for 

APR  5  and  must  be  less  than  4K -words. 

VMR  —  Illegal  error  severity  code  <code> 

Explanation:  This  message  indicates  an  internal  failure  in  VMR. 

If  this  error  message  persists,  contact  a  DIGITAL  software 
representative . 

VMR  —  Illegal  file  specification  <filespec> 

Explanation:  The  file  specification  printed  following  the  error 

message  has  an  illegal  format  or  contains  wildcards. 
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VMR  —  Illegal  first  APR 

Explanations  The  task  you  tried  to  install  was  built  using  an 
incorrect  base  APR.  The  following  rules  apply: 

1.  A  nonprivileged  task  must  be  built  with  APR  0  as  its  base 
APR. 

2.  A  privileged  task  that  does  not  map  into  the  Executive  must 
be  built  with  APR  0  as  its  base  APR. 

3.  If  the  Executive  is  16K-words  or  less,  a  privileged  task  that 
is  to  map  to  the  Executive  routines  and  data  structures  must 
be  built  with  APR  4  as  its  base  APR. 

4.  If  the  Executive  is  20K-words,  (or  less  on  RSX-11M-PLUS 
systems),  a  privileged  task  that  is  to  map  to  the  Executive 
routines  and  data  structures  must  be  built  with  APR  5  as  its 
base  APR. 

VMR  —  Illegal  function 

Explanation:  You  entered  a  command  that  VMR  does  not  recognize, 

or  the  command  line  refers  to  a  feature  that  is  not  supported  in 
the  system. 

VMR  —  Illegal  Get  Command  Line  < error  code> 

Explanation:  This  message  indicates  a  system  failure.  If  the 

error  persists,  contact  a  DIGITAL  software  representative. 

VMR  —  Illegal  keyword  value 

Explanation:  You  entered  a  value  for  a  keyword  that  is  out  of 

range . 

VMR  —  Illegal  operation  for  unmapped  system 

Explanation:  The  SET  /POOLSIZE  keyword  is  valid  only  on  mapped 

systems . 

VMR  —  Illegal  parameter  for  executive  common  partition 

Explanation:  You  specified  a  parameter  with  SET  /MAIN  that  is 

illegal  for  an  Executive  common.  The  partition  size  must  be 
200 (octal)  and  the  partition  type  must  be  COM. 

VMR  —  Illegal  priority 

Explanation:  You  specified  an  illegal  priority  for  the  task.  A 

priority  value  can  be  a  number  from  1  to  250.  250  is  the  highest 
priority  and  1  is  the  lowest  priority  you  can  assign.  A  priority 
is  assumed  to  be  octal  unless  you  put  a  period  ( . )  after  the 
priority  number . 

VMR  —  Illegal  slave  attribute 

Explanation:  You  attempted  to  install  a  task  with  the  /SLV 

keyword,  but  the  task's  name  is  in  the  form  . . .xxx.  The  task  is 
a  prototype  task  and  cannot  be  installed  as  a  slaved  task. 

VMR  —  Illegal  switch  <switch> 

Explanation:  The  switch  following  the  error  message  is  incorrect 

in  the  context  of  the  command  line  you  have  entered. 
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VMR  —  Illegal  use  of  <pname>  partition  or  common 

Explanations  You  attempted  to  install  a  task  in  a  CPU  or 
secondary  pool  partition. 

VM R  —  Illegal  use  of  <pname>  partition  or  region 

Explanation:  You  attempted  to  load  a  driver  into  a  common  or 

secondary  pool  partition. 

VMR  —  Illegal  use  of  wildcard 

Explanations  On  an  unmapped  system,  you  cannot  specify  a 

wildcard  (*)  with  the  following  SET  keywords:  /TOP,  /BOT,  and 
/POOL.  You  also  cannot  use  a  wildcard  for  the  size  parameter  of 
task  partitions . 

VMR  —  Illegal  value  for  symbol  <symname>  in  file  <filename> 

Explanations  LOAD  or  UNLOAD  has  determined  that  symbol  <symname> 
in  the  STB  <filename>  has  been  defined  to  an  illegal  value.  This 
can  occur  for  several  reasons,  some  general  and  some  specific  to 
individual  symbols.  For  example,  most  symbols  generally  cannot 
be  defined  to  zero  or  to  an  odd  number.  A  specific  example  is 

the  symbol  $INTSV,  which  must  not  be  referenced  by  mapped 

loadable  drivers. 

VMR  —  Incorrect  assignment  of  SY:  or  LB: 

Explanations  This  is  a  warning  message.  The  device  SY :  or  LB: 
is  not  assigned  to  the  same  device  as  the  system  image  file  you 
are  trying  to  work  with  in  VMR. 

VMR  —  Indirect  command  syntax  error  < command- line > 

Explanations  You  entered  an  improper  indirect  command  file 
specification . 

VMR  —  Indirect  file  depth  exceeded  < command- line > 

Explanations  You  attempted  to  reference  more  than  two  levels  of 
indirect  command  files . 

VMR  —  Indirect  file  open  failure  <command-line> 

Explanations  The  indirect  command  file  specified  in  the  command 
line  could  not  be  opened. 

VMR  —  Install  device  not  LBO : 

Explanations  You  attempted  to  install  a  task  from  other  than  the 
boot  device. 

VMR  —  Installed  tasks  or  commons  may  no  longer  fit  in  partition 

Explanations  This  is  a  warning  message.  You  shortened  a 
partition  so  that  the  tasks  and/or  commons  that  are  installed  in 
it  may  no  longer  fit.  VMR  shortens  the  partition  even  though 
this  situation  exists. 

VMR  —  Interrupt  vector  already  in  use 

Explanations  The  interrupt  vector  for  the  driver  being  loaded 
does  not  point  to  one  of  the  nonsense  interrupt  entry  points  in 
the  system  image . 
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VMR  —  Invalid  driver  data  base  at  offset  xxxx  in  file  <filename> 

Explanation:  The  driver  name  has  an  invalid  data  base  value  at 

offset  xxxx  relative  to  the  symbol  $ddDAT .  (See  the  RSX-11M 
Guide  tQ  Writing  an  I/O  Driver  or  the  RSX-11M-PLUS  Guide  to 
Writing  an  I/O  "Driver.  )  — 

VMR  —  Invalid  interrupt  vector 

Explanation:  You  specified  an  interrupt  vector  address  in  the 
driver  data  base  that  is  too  high  for  the  system  image. 

VMR  —  Invalid  keyword 

Explanation:  You  specified  a  keyword  that  is  incorrect  in  the 
context  of  the  command. 

VMR  —  Invalid  record  address  for  file  <filename> 

Explanation:  LOAD  has  attempted  to  write  outside  of  the  system 

image  file  or  at  a  byte  boundary.  Three  possible  causes  are  as 
follows : 

1 .  A  corrupted  system  image 

2.  An  STB  file  that  does  not  match  the  system  image 

3 .  An  internal  problem  in  VMR 
VMR  — .  Invalid  speed 

Explanation:  VMR  displays  this  message  for  either  of  the 

following  reasons: 

1.  You  reguested  a  speed  that  the  multiplexer  line  you  specified 
does  not  support. 

2.  You  specified  unequal  receive  and  transmit  speeds  for  a  DZ11, 
DZQ11,  or  DZV11  multiplexer.  These  multiplexers  do  not 
support  split  speeds. 

VMR  —  Invalid  time  parameter 

Explanation:  The  time  field  you  specified  in  the  RUN  command 

line  is  incorrect. 

VMR  —  Invalid  UIC 

Explanation:  You  specified  an  illegal  value  for  either  a  group 

number  or  a  member  number.  The  numbers  must  be  from  1  through 
377 (octal ) . 

VMR  —  I/O  error  on  input  file  <filename> 

Explanation:  An  input  I/O  error  occurred  on  the  indicated  file. 

VMR  —  I/O  error  on  output  device 

Explanation:  SAVE  has  encountered  an  I/O  error  on  the  output 

device  while  writing  the  system  image. 

VMR  —  I/O  error  on  output  file  <filename> 

Explanation:  An  output  I/O  error  occurred  on  the  indicated  file. 
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VMR  —  Keyword  not  supported  for  this  terminal  driver 

Explanation:  The  terminal  driver  selected  during  system 

generation  does  not  support  the  specified  SET  keyword.  For 
example ,  typeahead  is  a  full-duplex  terminal  driver  option  only 
and  your  system  uses  the  half-duplex  driver. 

VMR  —  KRB  <KRBname>  interrupt  vector  <octal-number>  in  use 

Explanation:  You  attempted  to  load  a  driver  that  specifies  an 

interrupt  vector  that  is  not  pointing  to  a  nonsense  interrupt 
entry  point  address.  This  is  usually  caused  by  a  previously 
loaded  driver  that  has  used  this  vector. 

When  you  get  this  message,  LOAD  has  loaded  the  driver  correctly, 
but  it  has  not  overwritten  the  interrupt  vector. 

VMR  —  KRB  <KRBname>  interrupt  vector  <octal-number>  too  high 

Explanation:  You  attempted  to  load  a  driver  that  specifies  an 

interrupt  vector  address  that  is  higher  than  the  highest 

permissible  vector  address  in  the  system. 

When  you  get  this  message,  LOAD  has  loaded  the  driver  correctly, 
but  it  has  not  overwritten  the  interrupt  vector. 

VMR  —  KRB  <KRBname>  not  in  loadable  data  base 

Explanation:  You  attempted  to  load  the  driver  for  a 

multicontroller  device  with  a  loadable  data  base.  The  special 
symbol  (KRBname)  that  defines  the  location  of  the  KRB  in  the 
multicontroller  device's  CTB  table  is  not  defined  in  the  loadable 
data  base.  See  the  RSX-11M-PLUS  Guide  to  Writing  an  I/O  Driver. 

VMR  —  KRB  table  of  CTB  <CTBname>  will  not  accept  KRB  <KRBname> 

Explanation:  You  attempted  to  load  the  driver  for  a 

multicontroller  device  with  a  loadable  data  base.  If  this 

operation  is  to  succeed,  then  the  following  conditions  must 
exist : 

1.  The  appropriate  slot  in  the  CTB  must  exist. 

2.  The  slot  in  the  CTB  must  be  unused. 

When  VMR  issues  this  error  message,  one  of  these  conditions  does 
not  exist.  See  the  RSX-11M-PLUS  Guide  to  Writing  an  I/O  Driver. 

VMR  —  Length  mismatch  common  block  <blockname> 

Explanation:  The  length  parameter  for  the  common  block,  as 

described  in  the  label  block  for  the  task  image,  does  not  match 
the  corresponding  length  parameter  defined  in  the  system  image. 
A  task's  label  block  data  must  match  system  data  for  that  task 
before  it  can  be  installed. 

VMR  —  Line  not  DZ11 

Explanation:  You  attempted  to  set  a  line  to  remote  that  is  not 

attached  to  a  DZ11,  but  your  system  uses  the  half-duplex  terminal 
driver . 


10-104 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  ( VMR) 


VMR  —  Loadable  driver  larger  than  4K 

Explanation*  This  is  a  warning  message.  You  are  loading  a 
driver  that  is  larger  than  4K-words. 

VMR  —  Loadable  driver  support  not  in  system 

®xPlanation :  You  attempted  to  load  a  device  into  a  system  image 

that  does  not  contain  the  Executive  routine  $INTSI.  The  routine 
is  needed  to  support  loadable  device  drivers. 

VMR  —  Logical  device  not  in  system 

Explanation:  The  device  you  specified  has  not  been  defined  and 
therefore  ASSIGN  could  not  find  it  in  the  logical  device 
assignment  table. 

VMR  —  LUN  out  of  range 

Explanation:  You  attempted  to  reassign  a  LUN  for  a  task  that  is 
higher  than  the  maximum  number  of  LUNs  allocated  for  the  task 
when  it  was  built. 

VMR  —  No  checkpoint  space,  assuming  not  checkpointable 

Explanation:  This  is  a  warning  message.  You  attempted  to 

install  a  task  as  checkpointable  that  was  not  built  as 
checkpointable.  This  means  that  there  is  no  checkpoint  space 
allocated  in  the  task  image  file.  Since  the  system  image  does 
not  support  the  dynamic  allocation  of  checkpoint  space,  INSTALL 
does  not  consider  the  task  to  be  checkpointable. 

VMR  —  No  checkpoint  space  or  dynamic  checkpoint  file 

Explanation:  You  attempted  to  install  a  task  built  with  external 
headers  or  as  checkpointable,  but  the  task  does  not  have  any 
checkpoint  space  and  the  system  does  not  have  a  checkpoint  file. 

VMR  —  No  ICB  pool  space  for  CPU  <cpu> 

Explanation:  The  Interrupt  Control  Block  (ICB)  pool  space 

allocated  for  CPU  <cpu>  has  been  exhausted. 

VMR  —  No  LUNs 

Explanation:  The  task  that  you  specified  as  an  argument  of  the 

LUN  command  does  not  have  any  logical  units  assigned  to  it.  This 
is  not  an  error  message;  rather,  it  is  simply  an  indication  that 
there  are  no  assignments  to  display. 

VMR  —  No  pool  space 

Explanation:  The  pool  space  required  to  load  the  driver  is  not 

available  in  the  system  image. 

VMR  —  No  room  available  in  STD  for  new  task 

Explanation:  There  is  no  dynamic  storage  available  to  make  an 

entry  in  the  System  Task  Directory  (STD).  The  task  cannot  be 
installed. 
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VMR 


_  No  table  space  for  optional  directive  common 


Explanations  You  attempted  to  fix  a  directive  common  in  the 
RSX-11M-PLUS  system  image,  but  the  extra  slots  built  into  the 
system  data  base  for  optional  directive  commons  have  all  been 
used . 

VMR  —  Nonexistent  memory 


Explanation: 
memory . 


You  attempted  to  define  a  partition  in  nonexistent 


VMR  —  Not  enough  APRS  for  task  image 

Explanation:  The  Task  Builder  allows  you  to  specify,  as  a 

multiple  of  4K,  the  virtual  base  address  of  a  task  image. 

Privileged  tasks  that  access  the  Executive  start  at  either 
virtual  address  lOOOOO(octal)  for  a  16K  Executive  or  at  virtual 
address  120000 (octal )  for  a  20K  Executive.  If  the  virtual  base 
address  of  the  task  is  set  too  high,  there  are  not  enough  APRs 

remaining  to  map  the  task  image.  (See  the  RSX-11M/M-PLUS  and 

Micro/RSX  Task  Builder  Manual  for  information  on  privileged 
tasks . ) 

VMR  —  Old  device  attached 

Explanation:  You  attempted  to  redirect  an  attached  device. 

VMR  —  Open  failure  on  file  <filename> 

Explanation:  The  indicated  file  cannot  be  opened. 

VMR  —  Operation  cannot  extend  above  first  124K  of  memory 


Explanation:  VMR  displays  this  message  for  either  of 

following  reasons : 


the 


1.  On  RSX-11M,  you  attempted  to  fix  a  task  above  124K-words. 
The  largest  system  that  can  be  saved  is  124K-words.  If  FIX 
allowed  you  to  fix  a  task  above  this  limit,  the  task  would  be 
lost  when  the  system  was  saved. 

2 .  You  attempted  to  create  with  the  SET  command  a  CPU  partition 
whose  upper  limit  is  above  124K-words. 

VMR  —  Operation  not  allowed  for  <ptype>  partitions 

Explanation:  You  attempted  a  SET  operation  that  is  not  allowed 

for  the  type  of  partition  specified  in  the  error  message. 

VMR  —  Optional  directive  common  successfully  loaded 

Explanation:  This  is  an  informational  message.  VMR  has 

successfully  fixed  in  the  system  image  a  directive  common  that  is 
not  one  of  the  commons  required  by  RSX-11M-PLUS . 


VMR  —  Partition  already  exists 

Explanation:  VMR  displays  this  message  for  either  of 

following  reasons : 


the 


1.  You  attempted  to  define  a  partition,  using  the  SET  command, 
with  a  name  already  in  use  as  a  partition  name. 

2.  You  attempted  to  define  a  subpartition,  using  the  SET 
command,  but  there  are  no  more  subpartition  slots  available. 
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VMR  —  Partition  or  common  region  is  busy 

Explanations  VMR  displays  this  message  for  any  of  the  following 
reasons : 

1.  You  attempted  to  fix  a  task  or  common  region  in  a  partition 
that  is  full.  The  task  or  region  cannot  be  fixed. 

2.  You  attempted  to  load  a  device  driver  into  a  partition,  but 
the  partition  is  full. 

3.  You  attempted  to  remove  a  partition  that  still  has  tasks 
installed  in  it.  The  partition  cannot  be  removed. 

4.  ( RSX-1 1M-PLUS  systems  only.)  You  attempted  to  remove  a  region 
that  is  referenced  by  tasks  installed  in  the  system. 

VMR  —  Partition  <pname>  is  a  common 

Explanation:  You  attempted  to  load  a  device  driver  into  a  common 

partition.  This  cannot  be  done. 

VMR  —  Partition  <pname>  is  not  a  common 

Explanation:  Partition  <pname>  was  found,  but  it  is  not  a  common 

partition . 

VMR  —  Partition  <pname>  is  too  small 

Explanation:  You  attempted  to  load  the  driver  into  a  partition 
that  is  either  too  small  for  the  driver  or  that  does  not 
currently  have  enough  space  for  the  driver.  Or,  you  attempted  to 
install  a  task  that  is  too  large  for  the  specified  partition. 

VMR  —  Partition  <pname>  not  in  system 

Explanation:  VMR  displays  this  message  for  either  of  the 

following  reasons: 

1.  The  partition  you  specified  in  the  command  line  is  not  in  the 
system  image. 

2 .  You  attempted  to  load  a  driver  into  a  partition  that  does  not 
exist  in  the  system,  or  LOAD  found  a  symbol  $xxCOM  in  the 
driver  and  partition  xxCOM  does  not  exist  in  the  system. 

VMR  —  Partition  <pname>  not  in  system,  defaulting  to  GEN 

Explanation:  This  is  a  warning  message.  You  attempted  to 

install  a  task  in  a  partition  that  does  not  exist.  VMR  will  try 
to  install  the  task  in  the  partition  GEN. 

VMR  —  Partition  not  system  controlled 

Explanation:  The  SET  command  keywords  /TOP  and  /BOT  are  valid 

only  for  system-controlled  partitions. 

VMR  —  Partition  reduced  to  executive  common  size 

Explanation:  This  is  an  informational  message.  When  an 

Executive  common  is  installed  in  its  partition,  the  partition  is 
reduced  to  the  top  of  the  common  to  eliminate  any  unused  space  in 
the  partition. 
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VMR  —  Pool  link  error  at  xxxx  Block=yyyy  zzzz 

Explanation:  When  SET  /POOL  traced  the  pool  linkage,  it  detected 

an  error  at  location  xxxx  in  the  system  image.  The  contents  of 
xxxx  is  yyyy  and  the  contents  of  xxxx+2  is  zzzz. 

VMR  —  Privileged  task  overmaps  I/O  page 

Explanation:  This  is  a  warning  message.  A  privileged  task  that 

may  need  access  to  the  I/O  page  does  not  have  that  access. 

A  privileged  task  that  is  mapped  to  the  Executive  is  often  mapped 
to  the  I/O  page  as  well.  However,  many  privileged  tasks  do  not 
require  access  to  the  I/O  page  and  can  use  the  extra  4K  of 
address  space  that  would  be  allocated  to  the  I/O  page  for  the 
task  image. 

If  the  task  does  not  require  access  to  the  I/O  page,  you  can 
ignore  this  message. 

VMR  —  Privileged  task  larger  than  12K 

Explanation:  You  attempted  to  install  a  privileged  task  that  is 

larger  than  12K-words.  (See  the  RSX-11M/M-PLUS  and  Micro/ RSX 
Task  Builder  Manual  for  information  on  privileged  tasks  ."5 

VMR  —  Pseudo  device  assignment  error 

Explanation:  You  attempted  to  assign  a  logical  device  name  to  a 

pseudo  device.  Logical  device  names  cannot  be  assigned  to  pseudo 
devices . 

VMR  —  Pseudo  device  redirect  error 

Explanation:  You  attempted  to  redirect  one  pseudo  device  to 

another  pseudo  device.  This  is  not  allowed. 

VMR  —  R/0  partition  <pname>  not  in  system,  defaulting  to  task's 

Explanation:  You  specified  a  read-only  partition  that  does  not 

exist  in  the  system.  INSTALL  will  place  the  read-only  portion  of 
your  multiuser  task  into  the  same  partition  as  the  read/write 
portion  of  the  task. 

VMR  —  Receive  data  or  by  reference  list  not  empty 

Explanation:  A  task  with  entries  in  its  receive  queues  cannot  be 

removed  from  the  system  image . 

VMR  —  Reference  to  memory  beyond  end  of  system  image  file 

Explanation:  VMR  attempted  to  fix  a  task,  load  a  driver,  or 

install  a  common  beyond  the  space  limits  of  the  system  image 
file.  As  a  result,  the  command  does  not  execute. 

VMR  —  Saved  system  truncated  to  n.  blocks 

Explanation:  (RSX-11S  systems  only.)  VMR  tried  to  save  a  system 

greater  than  n.  blocks.  This  results  in  VMR  truncating  the  saved 
image  file  to  n.:  112(decimal)  blocks  for  28K-word  systems  saved 
on  paper  tape,  488 (decimal)  blocks  for  122K-word  systems  saved  on 
RX01  diskettes,  and  496 (decimal)  blocks  for  124K-word  systems 
saved  on  all  other  bootable  devices. 
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VMR 


VMR 


VMR 


—  Space  used 

Explanation t  You  attempted  to  create  a  partition  in  a  storage 
area  that  is  already  occupied. 

Specified  partition  for  common  block 

Explanation:  You  attempted  to  install  a  task  in  a  common  block. 

—  Specified  partition  too  small 

Explanation:  This  message  can  occur  for  the  following  reasons: 


1 .  You  attempted  to 
smaller  than  the 

install 
task . 

a  task  into  a 

partition 

that  is 

2 .  You  attempted  to 
smaller  than  the 

install 

driver. 

a  driver  into  a 

partition 

that  is 

VMR  —  Symbol  <symname>  is  doubly  defined  by  file  <filename> 


Explanation:  The  symbol  symname  is  defined  twice  in  the 
specified  file.  Duplicate  symbols  are  illegal.  The  driver  is 
not  loaded  or  unloaded. 


VMR  —  Symbol  <symname>  is  undefined  in  file  <filename> 

Explanation:  LOAD  found  the  symbol  symname  in  the  specified 
file,  but  the  symbol  is  not  defined. 

VMR  —  Syntax  error 


Explanation:  You  have  typed  the  command  line  incorrectly. 
VMR  —  System  image  is  not  RSX-11M-PLUS 


Explanation:  You  attempted  to  use  RSX-11M-PLUS  VMR  on  a 
non-RSX-llM-PLUS  system  image  file. 


VMR  —  System  image  is  RSX-11M-PLUS 


Explanation:  You  attempted  to  use  RSX-11M  VMR  on  an  RSX-11M-PLUS 
system  image  file. 


VMR  —  Task  active 


Explanation:  The  task  you  specified  as  an  argument  of  the 

command  is  active. 


VMR  —  Task  and  partition  bases  mismatch 


Explanation:  The  base  of  the  partition  does  not  match  that  of 

the  task  being  installed  or  of  the  driver  being  loaded.  This 
message  applies  only  to  unmapped  systems. 

VMR  —  Task  or  common  region  already  fixed 

Explanation:  You  attempted  to  fix  a  task  or  common  region  in 

memory  that  is  already  fixed. 
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VMR  —  Task  has  attached  common  regions 

Explanations  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  fix  or  unfix  a  task  in  memory  that  is  linked 
to  a  shared  region.  VMR  cannot  fix  or  unfix  such  tasks. 

2 .  You  attempted  to  remove  a  task  that  is  linked  to  a  shared 
region  from  the  system  image.  VMR  cannot  remove  such  tasks. 

VMR  —  Task  image  currently  installed 

Explanations  You  attempted  to  install  a  checkpointable  task  that 
has  checkpoint  space  allocated  in  its  task  image.  The  task  has 
already  been  installed. 

The  system  allows  you  to  install  checkpointable  tasks  more  than 
once  subject  to  the  following  rules: 


1. 

You  must  allocate  checkpoint  space 
checkpoint  file. 

for 

the  task  in 

a  system 

2. 

You  must  use  a  different  name  for 
install  it. 

the 

task  each 

time  you 

VMR  —  Task  image  I/O  error 

Explanations  The  task  cannot  be  installed  or  the  driver  cannot 
be  loaded.  VMR  could  not  read  the  task  image  file  or  could  not 
rewrite  the  task  image  header •  The  specified  device  may  be 
write-locked . 

VMR  —  Task  image  virtual  address  overlaps  common  block  <blockname> 

Explanations  The  virtual  addresses  you  reserved  for  the  task 
image  overlap  those  you  reserved  for  the  common  block  specified 
in  the  error  message.  Corruption  of  the  task  image  file  may  have 
caused  the  overlap. 

VMR  —  Task  is  checkpointable 

Explanations  You  attempted  to  fix  a  checkpointable  task  in 
memory.  Checkpointable  tasks  cannot  be  fixed. 

VMR  —  Task  is  not  multi-user 

Explanations  You  attempted  to  fix  the  read-only  portion  of  a 
multiuser  task  in  memory,  but  the  task  you  named  in  the  command 
line  is  not  a  multiuser  task. 

VMR  —  Task  name  already  in  use 

Explanations  You  attempted  to  install  a  task  of  the  same  name  as 
that  of  one  already  installed  in  the  system  image. 

VMR  —  Task  not  installed  with  external  header 

Explanations  This  is  a  warning  message  to  indicate  that  the 
specified  task  is  installed  with  its  header  in  pool  (the  dynamic 
storage  region) . 

VMR  —  Task  not  in  system 

Explanations  You  referenced  a  task  that  is  not  installed  in  the 
system. 
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VMR  Task  not  removed,  CLI  has  messages  enabled 

Explanation:  You  attempted  to  remove  a  CLI  task  that  is  able  to 

reoeive  messages  from  the  system.  The  task  may  have  messages 
that  it  has  not  received  yet,  so  the  remove  request  is  aborted. 

VMR  —  Task  or  common  not  in  memory 


Explanation:  You  attempted  to  remove  a  task  or  common  from  the 

system  that  is  checkpointed  and,  therefore,  not  in  memory . 

-  Task  or  common  region  is  not  fixed 


Explanation:  You  attempted  to  unfix  a  task  that  is  not  fixed  in 

the  system  image . 


VMR  —  Task  or  common  region  not  in  system 

Explanation:  You  referenced  a  task  or  common  region  that  has  not 
been  installed  in  the  system  or,  on  RSX-11M-PLUS ,  you  attempted 
to  run  a  prototype  task. 

VMR  —  Task  requires  system  controlled  partition 

Explanation:  You  attempted  to  install  a  task  that  was  built  with 
external  header  (/XH)  support  and  as  checkpointable  (TKB  /CP,  INS 
/CKP— YES) .  Such  tasks  must  be  installed  in  a  system-controlled 
partition . 


VMR  —  TI  redirect  error 


Explanation :  You  attempted  to  redirect  the  pseudo  device  TI : • 

TI :  cannot  be  redirected. 

VMR  —  TT  redirect  error 

Explanation:  You  attempted  to  redirect  a  terminal  to  the  null 

device.  This  combination  is  not  allowed. 

VMR  —  Too  many  common  block  requests 

Explanation:  You  attempted  to  install  a  task  that  contains  too 

many  common  block  requests.  A  task  is  limited  to  seven  common 
block  references . 


VMR  —  Too  many  LUNs 

Explanation:  You  attempted  to  install  a  task  that  contains  more 

than  250(decimal)  LUN  assignment  requests. 

VMR  —  Too  many  symbols  of  the  form  $xxTMO  in  file  name 

Explanation:  LOAD  is  attempting  to  extract  symbols  of  the  form 

$ xxTMO  from  the  driver's  symbol  definition  file.  There  are  more 
symbols  of  this  form  than  LOAD  can  process. 

VMR  Top  of  pool  set  to  <value>,  requested  amount  not  available 

Explanation:  You  requested  more  pool  space  than  the  system  can 

provide.  The  system  provides  as  much  as  possible  in  this  case. 

VMR  —  Undefined  common  block  <blockname> 

Explanation:  You  attempted  to  install  a  task  that  references  a 

common  block  that  is  not  defined  in  the  system  image.  This 
message  may  indicate  that  the  task  was  built  for  another  system. 
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VMR  —  Unknown  partition 

Explanations  You  attempted  an  operation  on  a  partition  that  does 
not  exist  in  the  system. 


VMR  —  User  D-space  not  supported 


Explanations  An  attempt  was 
instruction  and  data  space  on 
D-space.  (User  D-space  is  a 


made  to  install  a  task  with  separate 
a  system  that  does  not  support  user 
system  generation  option.) 


VMR  —  Virtual  terminal  error 

Explanations  You  attempted  to  enable,  using  the  SET  command,  a 
terminal  option  for  a  virtual  terminal. 

VMR  —  Write-check  not  supported  for  device 

Explanations  You  attempted  to  enable  write-checking  for  a  device 
that  does  not  support  it.  Write-checking  is  supported  for  all 
disks  except  RLOls  and  RL02s  (DL:)  and  RXOls  (DXs). 
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COMMAND  LINE  INTERPRETERS 


11.1  INITIAL  CONCEPTS 

tf“  Ly,??y  task  "°r  »“  *-?«  —  - 

Unf^SS™  CLI  on.RSX-11M  a"d  RSX-11M-PLUS  systems  is  MCR,  which 
controls  the  operating  system.  MCR,  like  any  other  CLI  receives 
command  lines  that  originate  as  unsolicited  input^typed  on  a  terminal 
as  issued  by  a  task  using  an  Executive  directive.  Since  all  lines 

ayPtfSk'«,a  terrnal  are  ren  by  the  CLI  <excePt  those  used  to  satisfy 
a  task  s  read  requests),  the  CLI  task  is,  in  effect,  a  complete  user 

There^'is  *  the  USer  at  the  terming  is  ^bs^lut" 

application?  Y  t0  bypass  a  CLI  to  send  commands  to  the  system  or 

SrocLsor31^  an  efficJent  ™eans  ?f  interfacing  an  application  command 
processor  to  any  number  of  terminals,  since  no  read  QIO  or  character 

toTthe°CTiTSbn9,i1f  ^olved.  The  input  from  the  terminal  simply  goes 
to  the  CLI  by  default  for  processing.  y 

R^!iiM-mncr  in5roduces  the  concepts  of  CLIs  on  RSX-11M  and 
amo11M  PLUS  systems-  The  chapter  provides  enough  information  to 
allow  a  programmer  to  write  application-specific  CLIs.  A  brief 
description  of  three  DIGITAL  CLIs  supplied  with  the  system  illustrates 

^ese  three  system  CLIs  do  quite  different  things 
with  the  command  lines  they  process,  but  the  basic  goal  of  each  is  the 
same:  to  provide  a  specific  environment  for  the  terminal  user.  This 

asic  goal  also  applies  to  any  application-specific  CLIs,  which,  of 
course,  may  perform  completely  different  command  processing  functions, 
t  sa™?le  CLI  “  written  in  both  FORTRAN  and  MACRO-11  -  is 

included  in  this  chapter.  The  example  is  also  included  on  the 
istribution  kit  in  either  LB: [1,2]  with  the  HELP  files  or  in  the 
ew  user  directory  [ 200,1]  on  RSX— 11M  systems,  or  CUSERl  on 

"S:1  M-/LUS;-aS  ™Cf;;i:-MAC  and  TMCLI.FTN.  See  your  system  manager  for 
more  information.  The  example  illustrates  the  CLI  interface  and 
should  clarify  the  basic  operations  of  a  CLI. 


NOTE 

This  chapter  describes  features  available  on  RSX-11M 
and  RSX-11M-PLUS .  RSX-11S  systems  include  Basic  MCR. 
but  do  not  support  the  CLI  features  discussed  in  this 
chapter . 
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MCR  -  The  Traditional  RSX-11M/M-PLUS  CLI 


11.1.1 

.  .  t  /-iTT  nn  rsx-IIM/M-PLUS  systems  is  MCR.  MCR  receives 

The  most  important  CLI  on  RSX  *nd  ”xecutes  them  to  control  the  system. 

function  in  system  control  and  has  nothing 
CLI . 

resui?ingancLin°n^d9'not  even^be"  privileged.  The  only  similarity 
Eclated*  “^itr^t^^usr  ^S^teLtnal^n'’  an 

SS"fiSSL?SS  SLlTcS  do”s  not  permit^  SS  CL!  «£trX!  the 

use  of  the  terminal . 

NOTE 

While  MCR  is  a  CLI,  it  is  a  special  CLI.  MCR  does  not 
use  the  CLI  interface  directives  because  it  must  work 
on  systems  that  do  not  support  these  directives. 
Therefore,  MCR  is  not  a  pattern  for  other  RSX  11M  and 
RSX-1 1M-PLUS  CLIS. 


11.1.2  DCL  -  DIGITAL  Command  Language 


The  DIGITAL  Command  Language  (DCL)  interpreter  is  a  CLI  that  does  not 
actually  execute  any  commands.  DCL  provides  an  interface  tooperating 
system  features  by  translating  the  commands  it  receives  in  DCL  syntax 
to  the  equivalent  MCR  commands.  DCL  then  passes  the  transla 

command  liHe  to  the  appropriate  MCR  task  or  utility  execution . 

The  CLI  interface  hides  this  operation  from  the  user  at  the  terminal. 
Ho  does  Jot  need  to  know  about  MCR  or  the  utilities.  DCL  is  oriented 
towards  operations,  such  as  COPY  or  LINK,  rather  than  towards  tasks 
like  PIP  and  TKB .  DCL  presents  a  totally  different  external  inter  ace 
to  RSX-1 1M/M-PLUS,  one  that  is  easier  to  learn  and  use  than  MCR.  This 
makes  it  possible  for  less  technical  users  to  do  work  on 

RSX-1 1M/M-PLUS. 


11.1.3  RMT  -  DECnet  Remote  Terminal  Facility 

The  RMT  task  is  a  CLI  that  gathers  commands  from  the  terminals 
associated  with  it  and  sends  them  over  a  DECnet  network  to  be  executed 
on  a  remote  RSX-IIM/M-PLUS  system.  The  RMT  interface  provides  a 
mechanism  for  command  handling  with  a  minimum  of  overhead  or  effect  on 
user  tasks.  RMT  is  different  from  DCL:  RMT  does  not  interpret  the 
command  strings  it  handles,  while  all  DCL  does  is  RM^is 

All  the  interpretation  and  execution  of  commands  passed  through  RMT 
done  by  the  CLI  that  receives  the  commands  on  the  remote  system. 


11.2  WRITING  AN  APPLICATION  CLI 


A  CLI  is  an  RSX-IIM/M-PLUS  task,  like  any  other, 
privileged  unless  the  application  requires  it. 
expected  to  interact  with  the  operating  system 


It  need  not  be 
Any  alternate  CLI  is 
in  a  certain  way. 


11-2 


COMMAND  LINE  INTERPRETERS 


however.  TCiis  is  necessary  to  synchronize  with  the  operating  system 

,ha"dixng  and  PromPting .  This  interaction  is  achieved 
through  a  set  of  Executive  directives  for  CLIs . 


11.2.1  Executive  Directives  for  CLIs 

The  most  important  directive  is  GCCI$  (Get  Command  for  Command 

'  GCG?$  must  be  used  *>y  every  CLI,  no  matter  what  the  CLI 
does.  GCCI$  supplies  a  command  to  the  CLI  from  a  queue  maintained  by 

sy®tem-  also  controls  the  internal  status  bits  necessary  for 

correct  synchronization  of  prompting  and  general  command  handlinq  in  a 
manner  transparent  to  the  CLI  task.  y 


Other  CLI  directives  include  the  following: 

1.  RPOI$  (Request  and  Pass  Offspring  Information)  and  SDRP$ 
( Send,  Request ,  and  Pass),  which  can  be  used  to  pass  the 
responsibility  for  handing  a  command  off  to  another  task  so 
the  CLI  is  free  to  handle  another  command. 

2.  SCAA$  (Specify  Command  Arrival  AST),  which  specifies  an  AST 
in  the  CLI  whenever  a  command  arrives  for  processing  by  the 


3.  GCII $  (Get  Command  Interpreter  Information),  which  returns 
information  about  a  terminal  or  CLI  to  the  task. 

See  the  RSX-11M/M-PLUS  and  Micro/RSX  Executive  Reference  Manual  for  a 
complete  description  of  these  directives. 


11.2.2  Basic  Interaction  with  the  Operating  System 

Before  a  CLI  can  process  commands,  it  must  be  made  known  to  the 
system.  This  is  done  by  installing  the  CLI  task  with  the  /CLI=YES 
switch  and  then  initializing  the  CLI  with  the  CLI  /INIT  command.  This 
process  creates  an  internal  data  structure  that  allows  the  system  to 
recognize  the  existence  of  the  CLI.  See  the  RSX-11M/M-PLUS  MCR 
Operations  Manual  for  a  description  of  the  INSTALL  command  and  the  CLI 
commands . 

A  CLI  s  operation  starts  when  a  command  is  entered  into  the  system. 
The  command  may  originate  as  a  command  line  typed  on  a  terminal  or 
from  an  Executive  directive  issued  by  a  task.  The  source  of  the 
command  is  generally  irrelevant  to  the  CLI.  The  command  is  processed 
first  by  the  system  command  dispatcher  (the  MCR...  task).  This  task 
puts  the  command  into  a  FIFO  queue  of  commands  to  be  retrieved  by  the 
CLI.  The  CLI  associated  with  the  terminal  from  which  the  command 
originated  is  then  requested  to  run  (or  unstopped  if  it  is  already 
active)..  The  CLI  gets  the  command  from  the  system  by  issuing  the 
GCCI$  directive.  This  directive  removes  a  command  from  the  CLI ' s 
queue  and  copies  it  into  a  buffer  in  the  CLI 1 s  task  space.  GCCI$  can 
also  supply  information  about  the  source  terminal  to  the  CLI. 

Once  the  CLI  has  the  command,  it  is  free  to  process  it  in  any  manner 
it  chooses.  Generally  this  involves  executing  the  command,  or  passing 
the  command  to  another  task  for  execution.  If  the  CLI  is  going  to 
pass  the  command  to  another  (non-CLI)  task,  it  should  use  the  RPOI$  or 
SDRP$  directive  to  do  this,  assuming  the  CLI  has  no  further  interest 
m  the  command.  These  directives  propagate  the  information  the  system 
needs  for  controlling,  prompting  and  getting  exit  status  back  to  a 
parent  task  (if  any).  The  CLI ' s  obligations  to  the  command  are 
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complete  once  the  command  has  been  passed  off;  there  is  no  reason  for 
the  CLI  to  get  involved  again.  This  is  the  recommended  procedure  for 
handling  commands,  as  it  avoids  the  wait  for  the  preceding  command  to 
complete  execution.  DCL  works  in  this  way,  translating  a  command  into 
a  different  format  and  dispatching  it  to  another  task  for  execution. 

CLIs  that  process  commands  themselves  should  be  very  careful  about 
handling  any  possible  delays  in  execution.  This  is  especially  true  if 
the  CLI  is  to  do  I/O  to  a  terminal;  this  means  any  terminal  I/O, 
including  prompts  for  input.  Otherwise,  it  would  be  very  easy  for  one 
user  to  suspend  command  handling  by  not  responding  to  a  prompt  or  by 
pressing  CTRL/S. 

Once  a  CLI  has  completed  processing  a  command,  it  must  reissue  the 
GCCI$  directive  to  get  any  other  command  which  may  have  been  queued  to 
it  If  the  CLI  wants  to  stop  or  exit  when  no  commands  are  queued  to 
it'  it  should  do  this  by  issuing  the  GCCI$  directive  with  the 
appropriate  no-command  action  specified.  This  prevents  a  command 
queued  between  the  return  from  the  GCCI$  and  the  issuance  of  an  EXIT 
or  STOP  directive  from  being  lost,  or  not  processed  until  the  next 
command  is  queued. 


11.2.3  Task  Names  for  CLIs 

CLIs  can  be  installed  with  task  names  in  the  form  .  .  .  xxx  (commonly 
called  a  prototype  task  name)  or  with  names  in  some  other  legal  form, 
such  as  xxxxxx  (commonly  called  a  conventional  task  name). 

If  the  CLI  has  a  prototype  task  name,  the  system  creates  a  separate 
copy  of  the  CLI  each  time  a  command  is  entered  on  a  terminal  set  to 
that  CLI.  The  task  is  named  xxxtnn,  following  the  same  general  rule 
as  any  other  task  installed  in  the  system  with  a  prototype  task  name. 
Each  copy  of  the  CLI  runs  with  the  same  TI :  and  UIC  as  that  of  the 
terminal  the  command  came  from.  These  tasks  should  exit  when  there  is 
no  work  left  for  them  to  do. 

If  the  CLI  has  a  conventional  task  name,  all  commands  from  all 
terminals  associated  with  the  CLI  are  queued  to  a  single  copy  of  the 
task.  This  task  runs  with  a  TI :  of  CO:  (console  output  pseudo 
device).  CLIs  with  conventional  task  names  must  specify  the  TI :  and 
UIC  fields  in  any  RPOI$  or  SPWN$  directives  they  issue,  or  the  TI : 
and  UIC  will  not  default  correctly.  Because  there  is  only  one  copy  of 
these  tasks  in  the  system,  CLIs  with  conventional  task  names  can 
simply  stop  (rather  than  exiting)  when  there  are  no  commands  queued 
for  them.  This  may  be  necessary  if  the  CLI  must  maintain  information 
from  one  command  to  the  next. 

DCL  is  installed  with  a  prototype  task  name,  ...DCL.  RMT  is  installed 
as  RMT...,  with  a  conventional  task  name.  The  difference  reflects  the 
use  and  nature  of  each  CLI . 

DCL  must  be  installed  with  a  task  name  of  ...DCL  because  most  DCL 
commands  issue  prompts  for  input.  No  command  processing  can  be  done 
by  DCL  while  it  is  waiting  for  the  user  to  respond  to  a  prompt.  If 
^ere  were  only  one  copy  of  DCL  on  the  system,  command  processing  for 
all  DCL  terminals  would  stop  while  a  prompt  request  to  any  one 
terminal  was  outstanding.  This  is  clearly  not  an  acceptable 
situation.  Giving  each  terminal  its  own  copy  of  DCL  allows 
independent  command  processing  for  each  terminal.  To  avoid  filling 
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the  system  with  copies  of  DCL,  the  individual  copies  of  the  task  exit 
when  no  commands  are  left  for  them.  They  can  do  this  because  there  is 
no  need  to  maintain  any  context  between  commands. 

On  the  other  hand,  RMT  is  installed  as  RMT . . .  because  there  can  only 
be  one  copy  of  RMT  in  the  system.  This  is  because  RMT  provides  a 
focal  point  with  which  the  DECnet  command  handling  software  running  on 
the  remote  system  can  communicate.  Furthermore,  it  is  not  practical 
to  have  RMT  exit  when  no  commands  are  outstanding,  because  it  is 
necessary  to  maintain  context  between  commands.  If  each  user  got  a 
separate  copy  of  RMT,  the  system  would  be  cluttered  with  copies  of  RMT 
that  did  not  exit. 


11.2.4  MCR  Control  Commands 

The  MCR  CLI  command  is  the  means  by  which  the  system  has  knowledge  of 
CLIs.  The  CLI  command  has  switches  which  perform  such  functions  as 
making  a  CLI  known  to  the  system,  eliminating  it  from  the  system, 
turning  on  and  off  its  recognition  of  commands,  and  so  forth.  See  the 
RSX-11M/M-PLUS  MCR  Operations  Manual  for  a  description  of  the  CT.T 
command . 


11.2.5  System  Messages  to  CLIs 

Depending  on  the  nature  of  the  CLI ,  it  may  be  necessary  for  it  to 
receive  messages  notifying  the  CLI  of  the  occurrence  of  certain  events 
that  could  effect  it.  If  the  /MESSAGE  subkeyword  to  the  CLI  /INIT 
command  is  specified,  it  can  receive  messages  from  the  system 
informing  the  CLI  of  such  events.  These  messages  are  returned  by  the 
GCCI$  directive  just  like  commands.  They  can  be  differentiated  from 
commands  by  the  first  word  of  the  command  buffer  (G.CCDV)  being 
cleared,  instead  of  being  set  up  with  the  name  of  the  device  from 
which  the  command  originated.  The  code  identifying  which  message  is 
present  is  returned  in  the  unit  number  byte  (G.CCUN).  The  other 
fields  have  the  same  meaning  for  messages  as  they  do  for  commands . 
The  actual  text  field  of  the  buffer  may  be  empty  if  the  message  does 
not  contain  any  ASCII  text.  See  the  RSX-llM/M-PLUS  MCR  Operations 
Manual  for  further  information. 


NOTE 

The  CLI  command  includes  both  a  /MESSAGE  subkeyword  to 
the  /INIT  keyword  and  a  /MESSAGE  keyword.  The 
/MESSAGE  subkeyword  specifies  that  the  CLI  being 
initialized  can  receive  messages.  The  /MESSAGE 
keyword  sends  an  ASCII  message  to  a  CLI  that  has  been 
initialized  with  the  /MESSAGE  subkeyword.  See  the 
RSX-llM/M-PLUS  MCR  Operations  Manual  for  further 
information . 


11.2.5.1  CLI  Message  Descriptions  -  Message  codes  1  through 
127 ( decimal )  are  reserved  for  use  by  DIGITAL.  Users  wishing  to  create 
their  own  messages  to  CLIs  should  use  codes  in  the  range  of 
128(decimal)  through  255 (decimal) .  The  symbol  shown  for  each  message 
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code  is  defined 
LB : [ 1 , 1 ]EXELIB . OLB . 
with  that  library. 


in  the  Executive 
Tasks  may  pick  them  up 
Messages  are  as  follows: 


definition  library : 

at  build  time  by  linking 


CLI  Initialized  into  an  Enabled  Mode 


Message  Code:  1  (CM.INE) 

Text:  CLI  name  in  RAD50 ,  length  =  4  bytes 

Explanation:  This  message  is  sent  to  a  CLI  when  it  is 

initialized  by  a  CLI  /INIT  command  without  specifying  the 
/DISABLE  switch. 


CLI  Initialized  into  a  Disabled  Mode 
Message  Code:  2  (CM.IND) 

Text:  CLI  name  in  RAD50 ,  length  =  4  bytes 

Explanation:  This  message  is  sent  to  a  CLI  when  it 

initialized  by  a  CLI  /INIT  command  with  the  /DISABLE  switch. 


CLI  Enabled 

Message  Code:  3  (CM.CEN) 

Text:  None. 

Explanation:  This  message  is  sent  to  the  CLI  when  it  is  enabled 

by  a  CLI  /ENABLE  command. 


CLI  Disabled 

Message  Code:  4  (CM. CDS) 

Text:  None. 

Explanation:  This  message  is  sent  to  the  CLI  when  it  is  disabled 

by  a  CLI  /DISABLE  command. 


CLI  Eliminated 

Message  Code:  5  (CM. ELM) 

Text:  None. 

Explanation:  This  message  is  sent  to  a  CLI  when  it  has  been 

eliminated  by  an  explicit  CLI  /ELIMINATE  command. 


All  CLIs  Eliminated,  and  must  Exit 
Message  Code:  6  (CM. EXT) 

Text:  None. 

Explanation:  This  message  is  sent  to  all  CLIs  on  the  system 

which  were  initialized  with  the  /MESSAGE  subkeyword  to  the  CLI 
/INIT  command  when  a  CLI  /ELIM=*  command  is  issued.  A  CLI  that 
receives  this  message  should  exit  as  soon  as  possible,  since 
system  shutdown  or  other  emergency  procedure  is  taking  place. 
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Terminal  Linked  to  CLI 

Message  Code:  7  (CM.LKT) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of  terminal,  length  = 

4  bytes.  (2  bytes  each). 

Explanation:  This  message  is  sent  to  a  CLI  when  a  terminal 

becomes  associated  with  it.  This  message  could  result  from  a  SET 
command  processed  by  MCR,  or  any  other  use  of  the  SCLI$ 
directive . 


Terminal  Removed  from  CLI 

Message  Code:  8.  (CM.RMT) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of  terminal,  length  = 

4  bytes.  (2  bytes  each). 

Explanation:  This  message  is  sent  to  a  terminal's  former  CLI 

when  it  is  switched  to  another  CLI. 


General  Message 

Message  Code:  9.  (CM. MSG) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of  terminal  where  the 
CLI  /MESSAGE  command  originated,  followed  by  the  text  from  the 
command  string.  The  length  is  equal  to  the  length  of  the  string 
(possibly  zero)  plus  the  length  of  the  terminal  name  and  unit 
number  (2  bytes  each) . 

Explanation:  This  message  is  the  result  of  a  CLI  /MESSAGE 
command.  It  contains  whatever  text  the  issuer  of  the  command 
included  in  the  string,  plus  the  name  and  unit  number  of  the 
terminal  on  which  the  command  was  typed. 


11.2.6  Prompts  that  Affect  CLIs 


There  are  three  kinds  of 
CLIs.  These  prompts  are 

prompts  issued 
as  follows: 

by 

the  system 

that 

affect 

1.  CTRL/C  Prompts  - 

This  prompt 

is 

issued  by 

the 

terminal 

driver  when  it  receives  a  CTRL/C  character.  The  string  to  be 
issued  can  be  specified  when  the  CLI  is  initialized.  There 
is  no  way  the  CLI  can  be  notified  when  this  prompt  is  issued, 
however,  since  it  is  handled  by  the  terminal  driver.  These 
prompts  are  of  no  other  concern  to  CLIs. 
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2.  Empty-Line  Prompts  -  This  prompt  results  from  terminal  input 
consisting  solely  of  a  carriage— return  character/  which  is 
called  a  null  command  line.  The  standard  system  action  is  to 
have  the  MCR. . .  task  issue  the  default  prompt,  which  can  be 
specified  when  the  CLI  is  initialized.  The  CLI  can  be 
initialized  with  the  /NULL  switch,  which  causes  the  system  to 
send  null  command  lines  to  the  CLI  like  other  commands,  and 
not  output  anything.  Any  prompting  or  other  action  is 
therefore  the  CLI ' s  responsibility. 

3.  Task-Exit  Prompts  -  These  prompts  are  issued  when  a  task 

started  by  a  command  line  exits.  The  standard  system  action 

is  to  have  the  MCR...  task  issue  the  same  default  prompt 

string  as  in  the  case  of  an  empty  line.  If  the  CLI  wishes  to 

be  informed  of  these  occurrences,  it  can  be  initialized  with 
the  /PROMPT  switch,  which  causes  the  system  to  send  these 
task  exit  prompt  requests  to  the  CLI  without  terminal  output. 
Any  prompting  or  other  action  is  then  the  CLI  s 
responsibility. 

On  RSX-11M-PLUS  systems,  a  CLI  initialized  to  receive  either 
empty-line  or  task-exit  prompts  has  to  issue  an  SNXC$ 
directive  when  its  processing  of  the  prompt  is  complete. 

SNXC$  tells  the  terminal  driver  that  the  current  command  is 
complete,  and  it  can  send  the  next  one  if  the  terminal  is  in 
serial  processing  mode.  This  directive  can  be  issued  if  the 
terminal  is  not  in  serial  mode  without  any  adverse  effects . 
See  Section  11.2.6,  Serial  Command  Processing,  for  further 
details . 


11.2.7  System  Handling  of  Continuation  Lines 

Continuation  lines  are  handled  by  the  RSX-11M-PLUS  terminal  driver 
before  the  command  is  passed  to  the  CLI .  Incomplete  segments  of 
command  lines  are  detected  by  the  presence  of  a  hyphen  as  the 
character  immediately  preceding  the  terminator .  Any  hyphens  are 
removed  and  all  the  pieces  of  the  command  put  together  before  the  CLI 
is  aware  of  the  command,  so  the  CLI  does  not  have  to  deal  with 
continuation  lines  in  any  way.  If  the  CLI  does  not  want  the  system  to 
interpret  the  presence  of  the  hyphen  as  denoting  a  continuation  line, 
the  CLI  can  be  initialized  with  the  /SNGL  switch.  This  tells  the 
system  to  accept  single  line  commands  only,  and  pass  every  line  to  the 
CLI  as  it  is  entered.  No  continuation  line  checks  are  made. 

The  DCL  CLI  on  RSX-11M  does  its  own  handling  of  continuation  lines. 
This  is  done  within  DCL  itself,  and  is  not  available  as  a  general 
system  feature.  This  option  is  open  to  CLIs  on  RSX-11M  systems,  but 
is  not  necessary  for  CLIs  on  RSX-11M-PLUS  as  the  system  puts  all  the 
segments  together  before  the  command  is  sent  to  the  CLI . 


11.2.8  Interaction  with  Serial  Command  Processing  (RSX-11M-PLUS  only) 

Serial  command  processing  is  a  mode  in  which  commands  from  a  terminal 
are  executed  in  sequential  order,  with  a  command  not  being  started 
until  the  preceding  command  is  finished.  The  default  for  command  line 
processing  on  RSX-11M-PLUS  systems  is  parallel  processing,  but  a  CLI 
may  need  to  synchronize  commands.  Command  synchronization  is  achieved 
by  having  the  terminal  driver  store  characters  in  the  typeahead  buffer 
if  they  are  entered  while  a  command  is  outstanding  on  that  terminal. 
These  characters  are  issued  as  the  next  command  by  a  special  call  to 
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the  terminal  driver  at  the  completion  of  the  processing  of  the  current 
This  command  completion  is  normally  signalled  to  the  system 
hen  the  final  task  involved  m  the  processing  of  the  command  exits . 

If  a  task  -  either  the  CLI  or  a  task  chained  to  by  RPOI$  or  SDRPS  - 
bhe  c?mPlebion  of  conunand  execution  and  no  prompt  request  is 
generated  (meaning  the  command  was  terminated  by  an  ESCAPE  character) 

EiLn^?v^lnaTfdrirerviS  <Talled  directly  from  the  task  exit  code  in  the 
,  If  a  bask  exit  prompt  request  is  generated,  the  terminal 
driver  has  to  be  called  at  the  completion  of  the  prompt  request 

driverS1pal 1  If  ^  CLI  iS  n0t  feceivin9  Prompt  requests,  the  terminal 
never  get  involled  automatlcally  bV  system,  and  the  CLI  need 

If  the  CLI  has  been  initialized  to  receive  prompt  requests,  the  system 
passes  the  prompt  request  on  to  the  CLI  like  any  other  command.  It 
becomes  the  CLI  s  responsibility  to  write  any  prompt  string  to  the 
b®m^al  ' anf_  cal1  bhe  terminal  driver  to  initiate  the  next  command. 
The  CLI  should  therefore  issue  an  SNXC$  directive  at  the  completion  of 
its  processing  of  the  prompt  request. 

If  no  task  exit  occurs  to  terminate  the  command  execution,  the  system 
has  no  way  of  knowing  when  the  command  is  complete.  Therefore  the 
SNXC$  directive  must  be  used  to  mark  the  end  of  the  command  and  cause 
the  next  one  to  be  initiated.  Issuing  this  directive  causes  a  task 
exit  prompt  request  to  be  generated  if  one  would  have  been  generated 
by  a  task  exit.  If  no  prompt  request  is  generated,  SNXC$  calls  the 
terminal  driver  to  send  the  next  command  to  the  system  for  processing." 
This  directive  can  be  issued  by  the  CLI  or  the  final  task  chained  to 
it  by  means  of  an  RPOI$  or  SDRP$  directive. 

It  is  not  necessary  for  applications  using  the  SNXC$  directive  to 
check  if  a  terminal  is  actually  in  serial  mode.  If  the  terminal  is 
not  m  serial  mode,  the  terminal  driver  sends  commands  to  the  system 
as  they  are  entered.  The  directive  does  not  cause  the  terminal  driver 
to  be  called  because  it  is  not  necessary.  The  terminal  driver  still 
generates  a  task  exit  prompt  request  if  one  would  have  been  generated 
when  the  task  exited.  This  directive  clears  the  status  bits  that  tell 
the  system  to  generate  a  prompt  request  or  call  the  terminal  driver  at 
task  exit.  Therefore,  a  task  exiting  after  issuing  an  SNXC$  directive 
does  not  cause  two  prompt  requests  to  be  issued. 


See  the  RSX-11M/M-PLUS  and  Micro/RSX  Executive  Reference 
more  information  on  the  SNXC$  directive^  - 


Manual  for 


11.3  SAMPLE  CLI 

Following  is  a  sample  CLI,  written  in  both  MACRO-11  and  FORTRAN.  This 
sample  CLI  appears  in  the  simplest  form  possible,  so  you  can  easily 
learn  what  is  necessary  to  construct  a  CLI.  The  same  MACRO-11  and 
FORTRAN  programs  used  here  are  included  on  your  kit  as  TMCLI.MAC  or 
TMCLI. FTN.  The  primary  function  of  TMCLI  is  to  receive  commands  and 
pass  them  to  MCR  for  execution.  In  addition,  TMCLI  features  two 
single  letter  commands:  T  to  type  a  file  and  M  to  switch  back  to  MCR 
mo,?’  comments  in  each  sample  listing  suggest  several 
modifications  that  you  can  make  when  designing  or  setting  up  a  CLI. 
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11.3.1  MACRO-11  CLI 

♦  TITLE  TMCLI  -  EXAMPLE  CLI  THAT  IMPLEMENTS  *T*  AND  ■  M '  COMMAND 

♦  I  DENT  /l. 00/ 

i  THIS  TASK  (TMCLI)  ILLUSTRATES  THE  USE  OF  THF  CLI  CONTROL  DIRECTIVES  OF 
)  RSX-1 1M  V4.0  AND  RSX-UM-PLUS  V2 . 0 . 

?  WHEN  SET  UP  AS  A  TERMINAL'S  CLI .  IT  PROVIDES  THE  FOLLOWING  COMMANDS: 

}  T  ->  TYPE  FILE 

;  N  ->  SET  TERMINAL  TO  MCR 

1  IF  THE  FIRST  TWO  LETTERS  OF  THE  COMMAND  ARE  NOT  1 T  *  FOLLOWED 
}  BY  A  SPACE  »  OR  * M ‘  FOLLOWED  BY  A  CARRIAGE  RETURN  . 
i  THE  COMMAND  IS  PASSED  TO  MCR  FOR  EXECUTION.  THEREFORE. 

5  USERS  AT  TERMINALS  SET  TO  THIS  CLI  WILL  SEE  THE  ENTIRE  MCR  COMMAND  SET 
)  AS  BEING  PRESENT.  PLUS  THE  *T'  AND  *M'  COMMANDS.  IF  THE  /DPR  SUBKEYWORD 
»  IS  INCLUDED  ON  THE  CLI  /INIT  COMMAND.  USERS  WILL  KNOW  IMMEDIATELY  IF 
»  THEIR  TERMINAL  IS  SET  TO  THIS  CLI  BY  THF  DOUBLE  RIGHT  ANGLE  BRACKET  PROMPT. 

i  IF  TMCLI  IS  INITIALIZED  WITH  THE  /MESSAGE  KEYWORD.  TMCLI  WILL 
$  GREET  USERS  WHEN  THEIR  TERMINAL  IS  SET  TO  THE  CLI.  AND  SAY  GOODBYE 
i  TO  THEM  WHEN  THEY  SWITCH  AWAY. 

j  IN  ORDER  TO  BRING  THIS  CLI  UP  ON  THE  SYSTEM.  ISSUE  THE  FOLLOWING 
i  COMMAND  SEQUENCE? 

5 

i  >MAC  TMCLI. TMCLI/-SP=TMCLI 
i  >TKB  TMCLI. TMCLI/-SP=TMCLI. Cl. 1 IEXEI.IB/LB 
i  >INS  TMCLI/CLI=YES/TASK= . . .TMC 

>  >CLI  /INIT  =  TMCL. I/MESSAGE/ DPR=’<  15X12 >/>>/*/TASK=.  .  .TMC 

5  TO  SET  TERMINALS  TO  THIS  CLI.  ISSUE  THE  FOl.LOWING  COMMAND 

i  WHERE  TTNN!  IS  REPLACED  BY  THE  TERMINAL  NUMBER  OR  T I : 

i  >set  /cli=ttnn:tmcl.i 

i  NOTE  THAT  THE  PROMPT  ISSUED  IN  RESPONSE  TO  A  CONTROL. /C  DEFAULTS  TO  THE 
i  NAME  OF  THE  CLI.  WHICH  IS  "TMCLIV. 

\  TMCLI  CAN  BE  ELIMINATED  FROM  THE  SYSTEM  BY  THF  FOLLOWING  COMMANDS.  ASSUMING 
j  NO  TERMINALS  ARE  SET  TO  ITJ 

»  >CL I  /ELIh=TMCLI 
i  >REM  ...TMC 

5  EXPERIMENT  WITH  THE  OTHER  SUBKEYWORDS  OF  THE  CLI  /I.NIT  COMMAND.  THF  Cl.I 

>  /ENABLE  AND  CLI  /DISABLE  COMMANDS.  AND  WITH  THE  /MESSAGE  SWITCH  ON  THE  /INIT 
5  COMMAND  TO  OBSERVE  THE  EFFECTS.  ALSO  TRY  CHANGING  THE  /TASK= 

i  SWITCH  ON  THE  INS  AND  CL.I  /INIT  COMMAND  TO  ■  /TASK  =  TMCI. I  "  AND  NOTICE 
j  THAT  ONLY  ONE  COPY  OF  THE  TASK  WILL.  EXIST  FOR  ALL  TERMINALS.  RATHER  THAN 
»  ONE  PER  COMMAND.  J.F  YOU  DO  THIS.  YOU  SHOULD  ALSO  CHANGE  THE  OPTION 
i  ON  THE  GCCI$  DIRECTIVE  FROM  GC.CEX  TO  GC.CST  SO  THE  TASK  WILL.  STAY  ACTIVE 
:  BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT. 


. MCAL  L  GCCI$»RPOI$>EXIT$S»QIOW$.ALUN$.DIR$ 


DIRECTIVE.  DPBS 
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gcci: 

GCCI$ 

CMDBUF»CBLEN»IBUFfIBLENfO»GC.CEX 

rpoi: 

R  P  0 1  $ 

MCR.  .  . 

qiow: 

QIOW$ 

1 0 ♦ WVB , 5  r 1 , , , , < , ,  4  0  > 

alun: 

ALUN$ 

5 

f  BUFFER  AREAS 
r 

CMDBUFJ  ♦  BLKB  80.+G.CCBF 


CBLEN= . -CMDBUF 
♦  EVEN 

IBUFJ  .BLKB  G.CCCA+2 
IBLEN= . -I BUF 
.  EVEN 


» LENGTH  =  HEADER  PLUS  COMMAND  IN  BYTES 
' NOTE  THAT  ON  M-PLUS  THE  MAXIMUM  COMMAND 
r LENGTH  IS  255.  BYTES  t  SO  THE  LENGTH  SHOULD 
JBE  <255 • +G . CCBF>  OR  CHARACTERS  MAY  BE  LOST. 

f  CALCULATE  LENGTH 


’ LONG  ENOUGH  TO  CONTAIN  All.  INFORMATION 
5 CALCULATE  LENGTH 


tcmd:  .ascii  /pip  ti:=/ 

TCLEN= , -TCMD 

BUFJ  .BLKB  80 .  -TCL.EN 

.  EVEN 


i BASIC  PIP  COMMAND  TO  IMPLEMENT  ■ T *  COMMAND 
5 LENGTH  OF  COMMAND 
» BUFFER  TO  GENERATE  COMMANDS  IN 


MCRJ  .ASCII 

mcmd:  .ascii 

MCLEN= . -MCMD 
.EVEN 


/M/<15> 

XSET  /MCR=TItZ 


' STRING  TO  RECOGNIZE  AS  A  SFT  TO  MCR  RFQUFST 
' SET  TERMINAL  TO  MCR  COMMAND 
JLENGTH  OF  COMMAND 


TEXT  TO  BE  DISPLAYED  UPON  RECEIPT  OF  NEW  TERMINAI  -I  INKED 
TERMINAL-REMOVED  MESSAGES  FROM  SYSTEM 


LKT!  .ASCII  <15><12>/UELC0ME  TO  THE  EXAMPL.E  CL  I /< 1 5>< 1 2> 
LKTLEN= . -LKT 

.EVEN 


RMTJ  .ASCII 
RMTLEN= . -RMT 
.EVEN 


<15 > <  1 2 > / G 0 0 D  BYE  FROM  THE  EXAMPLE  CL  I/O  5X1  2> 


r  MESSAGE  FOR  CHARACTERS  LOST  DUE  TO 

f 

CHLGST:  ♦ A  S  C 1 1  < 15>< 12>/S0RRY,  part 

CLLEN= ♦ --CHLOST 


BUFFER  BRING  TOO  SMAI  L 

OF  YOUR  COMMAND  WAS  L.  0ST/<  1  5X1 2> 


ILLEGAL  COMMAND  MESSAGE 

ILL.:  ♦  ASCII  <15><12>/ ILLEGAL  C 0 M M A N D / <  1 

IL.LLEN-  ♦  -ILL  . 

♦  EVEN 


f  CL  I  CODE 


start: 


♦ ENABL 
D I R  $ 
BCS 


LSB 

*GCCI 

100$ 


* GET  a  COMMAND  FROM  SYSTEM 
5  IF  CS,  DIRECTIVE  ERROR 


>  IF  THE  G C C I $  DIRECTIVE  HAD  THE  GC*CST  OPTION  SPECIFIED,  UF  MAY  HAVF 
*  JUST  BEEN  UNSTOPPED,  SO  WE  HAVE  TO  GET  THE  COMMAND* 
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CMP 

* IS ♦ CLR , $DSW 

t WERE  1 

BEQ 

START 

5 1 F  EQ 

MOV 

♦CMDBUF , RO 

iPOINT 

TST 

(RO) 

US  TH 

BEQ 

MSG 

f  IF  EQ 

CMPB 

G.CCCT(RO) , G ♦ 

CCCL(RO) 

BLO 

150$ 

*,  IF  LO 

MOV 

#RP0I,R5 

J  POINT 

A  SYSTEM  MESSAGE? 


;  AT  THIS  POINT  ,  THE  CLI  HAS  A  COMMAND  TO  BE  PROCESSED ♦  THE  CODE  FROM 

i  THE  -START:-  LABEL  TO  HERE  SHOULD  BE  FAIRLY  COMMON  AMONG  ALL  CLIS. 

5  FROM  THIS  POINT  ON,  THE  CODE  WILL  BE  SPECIFIC  TO  THE  PARTICULAR  LANGUAGE 
i  THIS  CLI  IS  IMPLEMENTING  ♦  COMMANDS  CAN  BE  ADDED  OR  DELETED  AT  WILL 
;  BY  MODIFYING  CODE  IN  THIS  SECTION*  AS  STATED  ABOVE ,  THIS  EXTREMELY 
J  SIMPLE  CLI  PROVIDES  TWO  COMMANDS,  AND  GIVES  EVERYTHING  ELSE  TO  MCR* 
i  THIS  CREATES  AN  OPEN  ENDED  ENVIRONMENT*  REJECTING  UNRECOGNIZED  COMMANDS 
?  INSTEAD  OF  PASSING  THEM  TO  MCR  WOULD  LIMIT  THE  TERMINAL  USER'S  USE  OF 

i  THE  SYSTEM  TO  ONLY  THOSE  OPERATIONS  ALLOWED  BY  THE  CLI*  THIS  IS 

,  A  SECURE  WAY  OF  CONTROLLING  SYSTEM  USE,  IN  CASES  WHEN  IT  IS  NECESSARY* 

5  IN  THIS  EXAMPLE,  CHANGING  THE  " BNE  50$-  BELOW,  TO  A  "BNE  60$* 

5  WOULD  CREATE  AN  ENVIRONMENT  WHERE  THE  ONLY  OPERATION  A  USER  COULD 
i  PERFORM  WOULD  BE.  TO  TYPE  FILES  ON  THE  TERMINAL,  OR  SWITCH  BACK  TO  MCR* 
j  Al  I  OF  THE  REST  OF  THE  SYSTEM  IS  INACCESSIBLE*  IF  NO  MEANS  OF  SWITCHING 
;  BACK  TO  MCR  IS  PROVIDED,  IT  IS  IMPOSSIBLE  FOR  THF  USER  TO  DO 
J  ANYTHING  THE  CLI  DOES  NOT  EXPLICITLY  LET  HIM  DO* 


CMP 

#  "  T  , G ♦ CCBF ( RO ) 

*  IS 

IT 

A  -T-  COMMAND? 

BEQ 

10$ 

f  IF 

EQ 

YES 

CMP 

MCR , G ♦ CCBF ( RO ) 

;is 

IT 

AN  -M-  COMMAND? 

i  CHANGE  THE  NEXT  INSTRUCTION  TO  "BNE  60$"  TO  ELIMINATE  PASSING  UNKNOWN 
i  COMMANDS  TO  MCR* 

BNE  50$  5  IE  NE  NO 

*  THE  USER  HAS  ENTERED  AN  "M"  COMMAND,  SO  SET  THE  TERMINAL  TO  MCR. 

MOV  #MCMD , R ♦ POBF ( R5 )  i PUT  ADDRESS  OF  CMD  TO  ISSUE  IN  DPB 

MOV  *  M  0  L  E  N  ,  R  ♦  P  0  B  L  (  R  5  )  $  PUT  LENGTH  OF  CMD  IN  DPB 

BR  ISSCMD  J ISSUE  COMMAND 


THE  USER  HAS  ENTERED  A  "T"  COMMAND  SO  CONSTRUCT  THE.  NECESSARY  PIP 
COMMAND  AND  SEND  IT  TO  MCR* 


io$: 


20$: 


30$: 


MOV 

ADD 

MOV 

MOV 

MOVB 

CMPB 

BEQ 

CMPB 

BEQ 

MOVB 

INC 

BR 

MOV 

MOV 


RO ,  R 1 

♦G ♦ CCBF+ 1 , R 1 

#BUF,R2 

♦TCLEN , R4 

(R1)+,R3 

#15, R3 

30$ 


i  COPY  ADDRESS  OF  BUFFER  WITH  COMMAND 

iPOINT  TO  SPACE  AFTER  THE  T 

?  P 0 1 N T  TO  BUFFER  THAT  WILL  CONTAI  N  CMD 

J  GET  LENGTH  OF  INITIAL  PART  OF  COMMAND 

f GET  NEXT  CHARACTER 

US  IT  THE  END  OF  THE  COMMAND 

*,IF  EQ  YES 


*40, R3 


20$ 

R3, <R2)+ 
R4 
20$ 


ilS  IT  A  SPACE 

;IF  EQ  YES,  SKIP  IT 

f PUT  CHARACTER  IN  OUTPUT  BUFFER 

iCOUNT  CHARACTER 

i GET  NEXT  CHARACTER 


♦  TCMD,  R*  POBF  (  R5  )*,  PUT  ADDRESS  OF  CMD  TO  ISSUE  IN  DPB 
R4 , R ♦ POBL ( R5 )  ? INSERT  LENGTH  OF  COMMAND 
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muJouC^tMAND  WILL  BE  PASSED  to  THE  MAIN  COMMAND  DISPATCHER  (MCR...), 

n^crTTubLrnTART  A  C0PY  °F  PIP  AND  GIVE  IT  THE  COMMAND.  THE  RPOI 
?JnfCIIVE- COULD  BE  USED  TO  GIVE  THE  COMMAND  DIRECTLY  TO  ...PIP  AND 
GIVE  THE  RESULTING  TASK  A  DIFFERENT  NAME.  IN  THIS  EXAMPLE  t 
UE  COULD  CALL  THE  RESULTING  PIP  TASK  "TYPTNN"  WHERE  THE  LAST 

™ARACTERS  <TNN>  ARE  REPLACED  BY  A  DEVICE  NAME  CHARACTER  AND 
UNIT  NUMBER.  FOR  EXAMPLE,  IF  THE  'T*  COMMAND  WAS  TYPED  ON  TTIOI 
THE  RESULTING  TASK  NAME  COULD  BE  MADE  TO  BE  ■TYPTIO*.  THIS  HAS  THE 

?Nq?FlnGnp°^Ap!;Lc0fEItIG  ™E  TASK  T°  BE  AB0RTED  BY  A^  ‘ADO  TYP«  COMMAND » 
INSTEAD  OF  *ABO  PIP",  THUS  THE  USER  WOULD  NOT  HAVE  TO  KNOW  THAT  THE 


■T*  COMMAND  HE  ISSUED  IS  ACTUALLY  BEING  SERVICED 
IS  EXACTLY  WHAT  THE  DCL  CI.I  DOES.  IT  IS  NOT  DONE 
TO  SIMPLIFY  THE  EXAMPLE.  PICKING  UP  THE  TERMINAL. 
NUMBERi  CONVERTING  IT  TO  RAD50,  AND  SUPPLYING  IT 
ALONG  WITH  A  DIRECT  REQUEST  OF  PIP  IS  LEFT  AS  AN 
(BE  CAREFUL  ON  RSX- 1 1  M-PLtJS  SYSTEMS  WITH  MORE  THAN  64. 
NOTE  THAT  REQUESTING  PIP  DIRECTLY  AVOIDS  A  SUBSTANTIAL 
OVERHEAD. 


BY  THE  PIP  TASK.  THIS 
HERE 

NAME  AND  UNIT 
IN  THE  RPOI  DIRECTIVE 
EXERCISE  TO  THE  USER. 
TERMINALS)  . 
AMOUNT  OF  SYSTEM 


BR 


ISSCMD 


{EXECUTE  COMMAND 


COMMAND  IS  NOT  'T*  OR  "M*,  SO  GIVE  IT  TO  MCR  AS  IS. 

50$:  MOV  *CMDBUF+G.CCBF,R.P0BF(R5>  {PUT  ADDRESS  OF  STRING  IN  DPB 

MOVB  G.CCCT(RO) fR.POBL(RS)  {PUT  LENGTH  IN  RPOI  DPB 


ISSUE  RPOI $  DIRECTIVE  TO  EXECUTE  COMMAND 

ISSCMD:  MOV  ( RO ) , R , PODV ( R5  )  {PUT  NAME  OF  ISSUING  DEVICE  IN  RPOI 

MOVB  G.CCUN(RO) »R.P0UN(R5)  {COPY  UNIT  NUMBER 

MOVB  I BUF  +  G . CCPU  , R . POUM ( R5  )  {PROPAGATE  UIC  OF  TERMINAL 

MOVB  IBUF+G.CCPU+1,R.P0UG(R5) 

MOV  IBUF+G.CC0A»R.P00A(R5)  {COPY  ID  PARENT  IN  CASE  WE  WERE  SPAWNED 

DIR*  *RPOI  {PASS  COMMAND  TO  EXECUTOR  TASK 

BCC  START  {IF  CC,  SUCCESS 

BR  110$  {ERROR 


CONTROL  IS  TRANSFERRED  HERE  IF  UNKNOWN  COMMANDS  ARE  TO  BE  REJECTED 
INSTEAD  OF  BEING  PASSED  TO  MCR. 


60$: 

MOO 

♦  ILL  >  R1 

{POINT  TO  MESSAGE  TO  BE 

MOO 

♦  ILLLEN  f R2 

{GET  LENGTH  OF  MESSAGE 

CALL 

ISSMSG 

{ISSUE  MESSAGE 

BR 

START 

{TRY  FOR  NEXT  COMMAND 

>  ERROR 

HANDLING  CODE 

ioo$: 

CLR 

RO 

{FATAL  ERROR  ON  GCCI$ 

BR 

150$ 

110$: 

MOO 

#1  r  RO 

{FATAL  ERROR  ON  RPOI$ 

120$: 

IOT 

{FATAL 

150$: 

MOO 

♦  CHLOST  f R1 

{POINT  TO  MESSAGE  TO  BE 

MOO 

♦CLLEN, R2 

{GET  LENGTH  OF  MESSAGE 

CALL 

ISSMSG 

{ISSUE  MESSAGE 

BR 

START 

♦ DSABL 

LSB 

{  A  SYSTEM  MESSAGE  WAS  RECEIVED  INSTEAD  OF  A  COMMAND. 
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msg: 


CMPB 

♦CM.LKT .G.CCUN(RO)  » IS  : 

BEQ 

10$ 

5  IF  F.Q  1 

ChPB 

#Ch  ♦  RMT  f  G  ♦  CCIIN  ( RO  )  5IS 

BEQ 

20$ 

*  IF  EQ 

ChPB 

♦CM ♦ EXT  *G. CCU NIRO)  IIS 

BEQ 

50$ 

f  I F  EQ 

ChPB 

♦CM.ELM.G.CCUN(RO)  IIS 

BEQ 

50$ 

fIF  EQ 

BR 

START 

5  IGNORE 

ISSUE  WELCOME  MESSAGE 


10$J 

MOO 

#LKT  *  R1 

1  POINT  TO  MESSAGE  TEXT 

MOO 

♦  LKTLEN » R2 

*  GET  LENGTH 

ADD 

#G*CCBFfRO 

*  POINT  TO  TERMINAL  THAT 

BR 

30$ 

* 

f 

;  issue 

GOODBYE 

MESSAGE 

5 

20$: 

MOO 

*RMT»R1 

1  POINT  TO  MESSAGE  TEXT 

MOO 

♦RMTLEN  f R2 

IGET  LENGTH 

ADD 

*G*CCBF,RO 

{POINT  TO  TERMINAL  NAMF 

30$: 

CALL 

ISSMSG 

I  ISSUE  MESSAGE 

A 

V 

JMP 

START 

IGET  NFXT  COMMAND 

WHEN 


50$5 


AN  ELIMINATE  ALL  MESSAGE  IS  RECEIVED*  EXIT  IMMEDIATELY. 


EXIT$S 


ROUTINE  TO  PRINT  TO  TERMINAL. 


INPUTS! 


RO=ADDRESS  OF  NAME  OF  TERMINAL.  TO  PRINT  TO 
R1=ADDRESS  OF  MESSAGE  TO  PRINT 
R2=LENGTH  OF  MESSAGE 


OUTPUTS! 


NONE 


THIS  ROUTINE  PRINTS  THE  SPECIFIED  MESSAGE 
ALL  ERRORS  THAT  MIGHT  RESULT  ARE  IGNORED. 
DO  ASYNCHRONOUS  I/O  WITH  COMPLETION  ASTS. 


ON  THE  SPECIFIED  TERMINAL. 
IN  GENERAL*  CLIS  SHOULD 
AND  PROVIDE  A  TIME-OUT 


FACILITY  TO  KILL  THE  I/O  IF  IT  HASN'T  COMPLETED  IN  A  CERTAIN 
AMOUNT  OF  TIME.  THIS  PREVENTS  TERMINAL  I/O  FROM  HOLDING  LIP 
COMMAND  PROCESSING.  THIS  IS  NOT  DONE  HERE  FOR  SIMPLICITY. 


issmsg: 


10$: 


MOO 

(RO)  ,  AL.UN  +  A  .  L.LINA 

MOOB 

2  ( RO  )  .  AL..UN  +  A .  LUNIJ 

CLRB 

ALUN+A.LUNU+1  I 

D  IR$ 

♦  AL.UN  I 

DCS 

10$  5 

MOO 

R1  .QIOW  +  Q.  IOPL.  I 

MOO 

R2.0I0W+Q. IOPL+2 

D I  R$ 
RETURN 

tQIOU  I 

♦  END 

START 

*  SET  UP  DEVICE  NAME 

*  AND  UNIT  NUMBER 
CLEAR  HIGH  BYTE 

ASSIGN  LUN  5  TO  THE  SPECIFIED  DEVICE 

IF  CS*  SKIP  I/O 

SET  ADDRESS  OF  MESSAGE 

.INSERT  LENGTH  OF  MESSAGE 

DO  I/O  AND  WAIT  FOR  IT 
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11.3.2  FORTRAN  CLI 


pcJS1IuSh,(IM^,I)  1llusTRATES  THE  USE  OF  THE  CLI  CONTROL 
RSX-11M  V4*0  AND  RSX- 1 1 M-PLLJS  V2*0* 


DIRECTIVES  OE 


UHEN  SET  UP  AS  A  TERMINAL'S  CLI,  IT  PROVIDES  THE  FOLLOWING  COMMANDS: 


C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 


TYPE  FILE 

SET  TERMINAL  TO  MCR 


IF  THE  FIRST  TWO  LETTERS  OE  THE  COMMAND  ARE  NOT  "TB  F 0 1  LOWED 
BY  A  SPACE,  OR  " M "  FOLLOWED  BY  A  CARRIAGE  RETURN, 

THE  COMMAND  IS  PASSED  TO  MCR  FOR  EXECUTION ♦  THEREFORE, 

USERS  AT  TERMINALS  SET  TO  THIS  CLI  WILL  SEE  THE  ENTIRE  MCR  COMMAND  SET 

IS  INC|NUDFDEnNN?HFPn  ?  T/TMTTTrnANr'  C0MMANr,S*  IF  ™E  /DPR  SUBKEYWORD 
tuctdCtku?uJ,N  IHE  CLT  /INIT  COMMAND,  USERS  WILL  KNOW  IMMEDIATELY  IF 
HEIR  TERMINAL  IS  SET  TO  THIS  CLI  BY  THE  DOUBLE  RIGHT  ANGLE  BRACKET  PROMPT* 

IF  TMCL.I  IS  INITIALIZED  WITH  THE  /MESSAGE  KEYWORD,  TMCL  I  WTLL 
GREET  USERS  WHEN  THEIR  TERMINAL  IS  SET  TO  THE  CLI,  AND  SAY  GOODBYE 
TO  THEM  WHEN  THEY  SWITCH  AWAY*  YE 

commandRsequence»  ™IS  CLI  UP  °N  THE  systfm'  issuf  thf  following 

> FOR  TMCLI,TMCLI/-SP  =  TMCLI 

>TKB  TMCLI/FP,TMCLI/-SP=TMCLI,Cl,llEOROTS/l  B 

>INS  TMCLI/CL.I  =  YES/TASK=*  *  *TMC 

x-CL I  / INI  T  =  TMCL I /MESSAGE/ DPR=  "  <  1 5><  1 2>/>>/  ■  /  TASK :r-  ♦  «  ♦  TMC 

IF  USING  FORTRAN  IV-PLUS  INSTEAD  OE  FORTRAN  IV,  THE  FIRST  TWO 
COMMANDS  ABOVE  WOULD  BEJ 

>E4P  TMCL I , TMCL I/~SP=TMCLI ♦ ETN 
> T K B  TMC L I/F P, TMC L I/~SP  =  TMCL I, C1,11E4 POTS/LB 

TO  SET  TERMINALS  TO  THIS  CLI,  ISSUE  THE  FOLLOWING  COMMAND 
WHERE  TTNN:  IS  REPLACED  BY  THE  TERMINAL  NUMBER  OR  Tit 

> SET  /CLI  =  TTNN ♦ TMCL I 

NOTE  THAT  THE  PROMPT  ISSUED  IN  RESPONSE  TO  A  CONTROI../C  DEFAULTS  TO  THE 
NAME  OF  THE  CLI,  WHICH  IS  "TMCLI>"* 

InCr LE?f!®F  ELIMINATFD  FR™  THE  SYSTEM  BY  THE  FOLLOWING  COMMANDS,  ASSUMING 
NO  TERMINALS  ARE  SET  TO  I T » 

>CL I  /ELIM=TMCLI 
>REM  ...TMC 

EXPERIMENT  WITH  THE  OTHER  SUBKEYWORDS  OF  THE  CLI  /INIT  COMMANIW  THE  CLI 
/ENABLE  AND  CLI  /DISABLE  COMMANDS*  AND  WITH  THE  /MESSAGE  SWITCH  ON  THE  /INIT 
COMMAND  TO  OBSERVE  THE  EFFECTS.  ALSO  TRY  CHANGING  THE  /TASK= 

SWITCH  ON  THE  INS  AND  CLI  /INIT  COMMAND  TO  */TASK=TMCLI *  AND  NOTICE 
THAT  ONLY  ONE  COPY  OF  THE  TASK  WILL  EXIST  FOR  ALL  TERMINALS.  RATHER  THAN 
ONE  PER  COMMAND.  IF  YOU  DO  THIS,  YOU  SHOULD  ALSO  CHANGE  THE  OPTION 
ON  THE  GTCMCI  DIRECTIVE  FROM  GC.CEX  TO  GC.CST  SO  THE  TASK  WILL  STAY  ACTIVF 
BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT. 
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BUFFER  AREAS 


C 

C 

C 


C 

C 

c 


c 

c 

c 


COMMAND  BUFFER 


THIS  BUFFER  IS  USED  IN  THE  GTCMCJ  DIRECTIVE*  IT  CON¬ 
TAINS  INFORMATION  ON  THE  COMMAND  RECEIVED  (8  BYTES) 

AND  THE  COMMAND  TEXT* 

integerSTcblen’  I  note  that  on  m+  the  maximum  command 

DATA  CBI FN/263/  !  LENGTH  IS  255* 

INTEGER*2  GCCDV*  GCCCl.  !  ASCII  DEV  NAM»  *  CHARS  IN  CMD  LINE 
BYTE  GCm  r  GCCUNf  GCCBF  ( 255 )  !  #  OF  CHARS*  TERMINAL  UNIT  ♦  *  CMD 

EQUIVALENCE  ( GCCDV * CMDBUF ) *  ( GCCCL * CMDBUF ( 5 )> *  ( GCCCT * CMDBUF ( 4 ))  , 

1  (GCCBF  *CMDBUF(9)  )  *  ( GCCIJN  *  CMBBIJF  (  3 )  ) 

INFORMATION  BUFFER  -  ALSO  RETURNED  IN  THE  GTCMCI  DIRECTIVE. 

BYTE  IBUF ( 1 4 > 

INTEGER*2  GCCPU 

DATA  IBLEN/14  /  *  GCCF'U/9/  !  LENGTH  OF  IBUF*  LOGIN  UIC  OFFSET 
INTEGERK4  GCCOA  !  A DDR  OF  OFFSPRING  CONTROL  BLOCK  FROM  PARENT 

EQUIVALENCE  ( GCCOA » IBUF ( 7 ) ) 

BUFFER  IN  WHICH  TO  GENERATE  COMMANDS 


BYTE  BUF ( 72 ) 

REALMS  TCMD ( 2 ) 
EQUIVALENCE  (BUF. TCMD) 

MCR  TASK  NAME  IN  RAD50 

INTEGER*4  IMCR 
DATA  IMCR/6RMCR.  .  ./ 


!  BUFFER  IN  WHICH  TO  GENERATE  COMMANDS 
!  FOR  CONVENIENCE  IN  ASSIGNMENT  STATEMENTS 


!  MCR  TASK  NAME  IN  RAD50 


DIRECTIVE  SYMBOLIC  VALUE  DEFINITIONS 

INTFGER*2  GCCCS,  GCCEX.  GCCST  *  GCCND 

DATA  GCCCS*  GCCEX,  GCCST*  GCCND  /O*  1*  2*  128/  !  INCP  VALUES  IN  GTCMCI 

DATA  ISCLR  /O/  !  IS.CLR  RETURN  CODE 

INTEGER*2  CMELM ,  CMEXT ,  CMI..KT ,  CMRMT  !  TERMINAL  CODES  FOR  SYSTEM  MSGS 
DATA  CMELM,  CMEXT*  CMLKT *  CMRMT  /5*  6*  7*  8/ 

CLI  CODE 

TO  FORCE  THE  CLI  TO  EXIT  INSTEAD  OF  RETURNING*  THE  GC.CF.X  OPTION  IS  SPECI¬ 
FIED  IN  THE  GTCMCI  DIRECTIVE  BELOW.  IF  THE  CLI  IS  INSTALLED  SO  THAT  ONLY 
ONE  COPY  OF  THE  TASK  WILL  EXIST  FOR  ALL  TERMINALS*  CHANGE  THE  VARIABLE 
GCCEX  BELOW  TO  GCCST.  THIS  SPECIFIES  THE  GC.CST  OPTION  SO  THAT  THE  TASK 
WILL  STAY  ACTIVE  BUT  STOPPED  WHEN  NO  COMMANDS  ARF  OUTSTANDING  FOR  IT. 

1  CALL  GTCMCI (CMDBUF* CBLEN* IBUF * IBl.EN * 0 * GCCEX *  IDS)  !  GET  CMD  FOR  CLI 
IF  (IDS  .LT.  0)  GO  TO  100 

IF  THE  GTCMCI  DIRECTIVE  HAD  THE  GC.CST  OPTION  SPECIFIED*  WE  MAY  HAVE 
JUST  BEEN  UNSTOPPED*  SO  WE  HAVE  TO  GET  THE  COMMAND. 


IF  (IDS  .EQ.  ISCLR)  GO  TO  1 
IF  ( GCCDV  .EQ.  0)  GO  TO  200 
IGCCUN  =  GCCUN 

CALL  ASNLUN(5*GCCDV,  IGCCIJN*  IDS) 
IGCCCT=GCCCT 

IF  ( IGCCCT  .GE.  0)  GO  TO  5 
IGCCCT  =  256  +  IGCCCT 
IF  (IGCCCT  .LT.  GCCCL)  GOTO  150 


!  WERE  WE  JUST  UNSTOPPED? 

!  IS  THIS  A  SYSTEM  MESSAGE? 

!  CONVERT  BYTE  TO  INTEGER  (UNIT  *) 

!  ASSIGN  TERMINAL  TO  LlIN  5 
!  CONVERT  BYTE  TO  INTEGER 

!  CONVERT  NEGATIVE  TO  UNSIGNED 

DID  ENTIRE  COMMAND  FIT  IN  BUFFER? 
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C 

C 

C 

C 

C 

C 

C 

C 

C 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 


?LT^Lr°™I:  THE  CLI  HAS  A  C0MMANr'  to  be  processed,  the  code  from 

THE  LABEL  1  TO  HERE  SHOULD  BE  FAIRLY  COMMON  AMONG  Al  I  Cl  IS. 

n  ?STq0?JIJ.  BE  SPECIFIC  ™  THE  PARTICULAR  LANGUAGE 

THIS  CLI  IS  IMPLEMENTING.  COMMANDS  CAN  BE  ADDED  OR  DFLFTFD  AT  WILL 

BY  MODIFYING  CODE  IN  THIS  SECTION.  AS  STATED  ABOVE.  THIS  EXTREMELY 
SIMPLE  CLI  PROVIDES  TWO  COMMANDS.  AND  GIVES  EVERYTHING  ELSF  TO  MCR 
THIo  CREATES  AN  OPEN-ENDED  ENVIRONMENT.  REJECTING  UNRFCOGNT7FD  COMMANDS 
INSTEAD  OF  PASSING  THEM  TO  MCR  WOULD  LIMIT  THF  TFRMTNA  USER'S  us£  OF 
THE  SYSTEM  TO  ONLY  THOSE  OPERATIONS  ALLOWED  BY  THE  CLI .  tSiS  IS 
A  SECURE  WAY  OF-  CONTROLLING  SYSTEM  USE>  IN  CASES  WHFN  IT  IS  NFrESSARY 
IN  THIS  EXAMPLE.  CHANGING  THE  " GO  TO  50-  BELOW,  TO  A  'GO  TO  Jo- 
WOULD  CREATE  AN  ENVIRONMENT  WHERE  THE  ONLY  OPERATION  A  USFR  COULD 

AM  FnEMTMcUpc  cfnI°TTYPE  FILES  0N  THE  ^RHINAL,  OR  SWITCH 'back  ™  MCR. 
AFL0E  rHE  REST  THE  SYSTEM  IS  INACCESSIBLE.  IF  NO  MEANS  OF  SWITCHING 
BACK  TO  MCR  IS  PROVIDED.  IT  IS  IMPOSSIBLE  FOR  THF  USER  TO  DO 
ANYTHING  THE  CLI  DOES  NOT  EXPLICITLY  LET  HIM  DO. 


IS  IT  A  ■ T *  COMMAND? 


IF  ( ( GCCBF ( 1 )  .EQ.  'T')  .AND. 
C 

C  CHANGE  THE  NEXT  IF  STATEMENT  TO  "GO 
C  COMMANDS  TO  MCR. 

C 


( GCCBF ( 2 )  .EQ.  '  ' ) )  GO  TO  10 
TO  60*  TO  ELIMINATE  PASSING  UNKNOWN 


C  IS  IT  ALSO  NOT  AN  -M-  COMMAND'!’ 

C 

IF  ( ( GCCBF ( 1 )  . NE .  'M' )  .OR.  (GCCBE(2>  , NE .  IS))  GO  TO  50  !  M<CR> 
C  THE  USER  HAS  ENTERED  AN  ,MI  COMMAND,  SO  SET  THE  TERMINAL.  TO  MCR. 


TCMD(l)  =  'SET  /MCR' 

TCMD ( 2 )  =  ' =T I J  '  !  SET  /MCR=TI t 

IGRP  =  I BLIF  ( GCCPU+1 )  !  (CONVERT  BYTE  TO  INTEGER)  GROUP 

IMEM  =  I BUE ( GCCF’U )  !  MEMBER  PART  OF  UIC 

C 

C  ISSUE  R  P  0 1  $  DIRECTIVE  TO  EXECUTE  COMMAND 
C 

CALL.  RPOKIMCR,  IGRP.  IMEM,  »TCMD»12»,GCCDV,IGCCUN,,GCC0A»IDS) 
IE  (IDS  .  L.E .  0)  GO  TO  110  !  ERROR? 

60  TO  1  !  BACK  TO  START 

C 

C  THE  USER  HAS  ENTERED  A  ■ T *  COMMAND  SO  CONSTRUCT  THE  NFCFSSARY  PIP 
C  COMMAND  AND  SEND  IT  TO  MCR 
C 


10 


20 

30 

C 

C  ISSUE 
C 


TCMD ( 1 )  =  'PIP  T 1 5  =  ' 

12  =  8 

DO  20,  II  =  10,  CBLEN 
IF  ( CMDBUF (It)  .EQ. 
IE  (CMDBUF (II)  .EQ. 
12  =  12  +  1 
BUE ( 1 2 )  =  CMDBUF (II) 
CONTINUE 

IGRP  =  IBUF ( GCCPU+1 ) 
IMEM  =  IBUF(GCCPU) 


!  PUT  BEGINNING  OF  PIP  CMD  IN  BUFFFR 
!  POINTER  INTO  TARGET  BUFFER 
!  BEGIN  AT  SPACE  AFTER  THE  T  IN  CMDBUF 
13)  GO  TO  30  !  END  OF  COMMAND?  (<CR>) 

'  ')  GO  TO  20  !  SKIP  ANY  SPACES 
!  COUNT  CHARACTER 
!  COPY  INTO  OUTPUT  BUFFER 

!  (CONVERT  BYTE  TO  INTEGER)  GROUP 
!  MEMBER  PART  OF  UIC 


RPOI$  DIRECTIVE  TO  EXECUTE  COMMAND 


CALL  RPOI ( I MCR, IGRP, IMEM. , TCMD, 12, , GCCDV , IGCCUN , .GCCOA, IDS) 
IF  (IDS  .LE.  0)  GO  TO  110  !  ERROR? 

60  T°  1  !  BACK  TO  START 
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C  IN  THE  ABOVE  SECTION  OF  CODE  *  THE  RPOI  DIRECTIVE  WAS  USED  TO  PASS 
C  THE  PIP  COMMAND  TO  THE  MAIN  COMMAND  DISPATCHER  <MCR***>* 

C  WHICH  WILL  START  A  COPY  OF  PIP  AND  GIVE  IT  THE  COMMAND ♦  THE  RPOI 
C  DIRECTIVE  COULD  BE  USED  TO  GIVE  THE  COMMAND  DIRECTLY  TO  ♦♦♦PIP  AND 
C  GIVE  THE  RESULTING  TASK  A  DIFFERENT  NAME ♦  IN  THIS  EXAMPLE  * 

C  WE  COULD  CALL  THE  RESULTING  PIP  TASK  ■ TYPTNN "  WHERE  THE  LAST 
C  THREE  CHARACTERS  ( TNN )  ARE  REPLACED  BY  A  DEVICE  NAME  CHARACTER  AND 
C  UNIT  NUMBER ♦  FOR  EXAMPLE*  IF  THE  ■ T  *  COMMAND  WAS  TYPED  ON  TTIO  ♦ 

C  THE  RESULTING  TASK  NAME  COULD  BE  MADE  TO  BE  "TYPTIO"*  THIS  HAS  THE 
C  ADVANTAGE  OF  ALLOWING  THE  TASK  TO  BE  ABORTED  BY  AN  "ABO  T  Y  P  *  COMMAND  * 

C  INSTEAD  OF  "ABO  PIP" *  THUS  THE  USER  WOULD  NOT  HAVE  TO  KNOW  THAT  THE 
C  "T"  COMMAND  HE  ISSUED  IS  ACTUALLY  BEING  SERVICED  BY  THE  PIP  T ASK ♦  THIS 
C  IS  EXACTLY  WHAT  THE  DCL  CLI  DOES ♦  IT  IS  NOT  DONE  HERE  IN  ORDER 
C  TO  SIMPLIFY  THE  EXAMPLE ♦  PICKING  UP  THE  TERMINAL  NAME  AND  UNIT 
C  NUMBER  *  CONVERTING  IT  TO  RAD50  *  AND  SUPPLYING  IT  IN  THE  RPOI  DIRECTIVE 
C  ALONG  WITH  A  DIRECT  REQUEST  OF  PIP  IS  LEFT  AS  AN  EXERCISE  TO  THE  USER ♦ 

C  (BE  CAREFUL  ON  RSX-11M-PLUS  SYSTEMS  WITH  MORE  THAN  64*  TERMINALS) ♦ 

C  NOTE  THAT  REQUESTING  PIP  DIRECTLY  AVOIDS  A  SUBSTANTIAL  AMOUNT  OF  SYSTEM 
C  OVERHEAD ♦ 

C 

C 

C 

C  COMMAND  IS  NOT  "T"  OR  "M"t  SO  GIVE  IT  TO  MCR  AS  IS* 

C 

50  IGRP  =  IBUF ( GCCPU+1 )  !  (CONVERT  BYTE  TO  INTEGER)  GROUP 

IMEM  =  IBUF ( GCCPU )  !  MEMBER  PART  OF  UIC 

IGCCCT  =  GCCCT  !  *  OF  CHARS  IN  COMMAND 

ISSUE  R P 0 1 $  DIRECTIVE  TO  EXECUTE  COMMAND 

CALL  RPOI ( I MCR  v IGRP  * IMEM  *  * GCCBF * IGCCCT  > * GCCDV * IGCCUN *  * GCCOA *  I DS > 
IF  (IDS  ♦ LE ♦  0)  GO  TO  110  !  ERROR? 

GO  TO  1  !  BACK  TO  START 

CONTROL  IS  TRANSFERRED  HERE  IF  UNKNOWN  COMMANDS  ARE  TO  BE  REJECTED 
INSTEAD  OF  BEING  PASSED  TO  MCR* 


60  WRITE  (5*62) 

62  FORMAT ( 'OILLEGAL  COMMAND') 

GO  TO  1  !  BACK  TO  START 

ERROR  HANDLING  CODE 


100 

102 


WRITE  (5*102)  IDS 
FORMAT( 'OFATAL  ERROR 
GO  TO  250 


!  ERROR  IN  GTCMCI 
IN  GTCMCI  DIRECTIVE* 
!  EXIT 


D  S  W  =  '  *  1 6  ) 


110 

112 


WRITE  (5*112)  IDS 
FORMAT ( 'OFATAL  ERROR 
GO  TO  250 


!  ERROR  IN  RPOI 
IN  RPOI  DIRECTIVE* 
!  EXIT 


D  S  W  =  '  *  1 6  ) 


150 

152 


WRITE  (5*152) 

FORMAT( 'OSORRY*  PART  OF 
GO  TO  1 


!  ENTIRE  COMMAND  DID  NOT  FIT  IN  BUFFER 
YOUR  COMMAND  WAS  LOST') 

!  BACK  TO  START 


A  SYSTEM  MESSAGE  WAS  RECEIVED  INSTEAD  OF  A  COMMAND 


CONTINUE 

IF 

( GCCUN 

♦  EQ* 

CMLKT ) 

GO 

TO 

210  i 

!  IS 

IT 

A  NEW  TERMINAL  L 

INKED  TO  US? 

IF 

( GCCUN 

♦  EQ. 

CMRMT ) 

GO 

TO 

220 

!  IS 

IT 

A  TERMINAL  BEING 

REMOVED? 

IF 

(GCCUN 

♦  EQ* 

CMEXT ) 

GO 

TO 

250  i 

!  IS 

IT 

AN  ELIMINATE  ALL 

PACKET? 

IF 

(GCCUN 

♦  EQ* 

CMELM ) 

GO 

TO 

250 

!  IS 

IT 

A  CLI  ELIMINATION  MESSAGE? 

GO 

TO  1 

i 

!  IGNORE 

ALL 

OTHER  MESSAGES 
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ISSUE  WELCOME  MESSAGE 

210  IGCCUN  =  CMDBUE (11)  !  CONVERT  BYTE  TERMINAL  UNIT  #  TO  INTEGER 

CALL  ASNLUN (5 . GCCBF . IGCCUN » IDS)  !  ASSIGN  LUN  5  TO  SPECIFIED  DFVICE 
WRITE  (5.212)  " 

212  EORMAT< 'OWELCOME  TO  THE  EXAMPLE  CLI  '  ) 

G0  T0  1  !  BACK  TO  START 

ISSUE  GOODBYE  MESSAGE 

220  IGCCUN  =  CMDBUF (11)  !  CONVERT  BYTE  TERMINAL  UNIT  *  TO  INTEGER 

CALL  ASNLUN(5»GCCBF» IGCCUN. IDS)  !  ASSIGN  LUN  5  TO  SPECIFIED  DEVICE 
WRITE  ( 5 » 222 ) 

222  FORMAT ( ' OGOOD  BYE  FROM  THE  EXAMPLE  CLI') 

GG  TO  1  !  BACK  TO  START 

WHEN  AN  ELIMINATE  ALL  MESSAGE  IS  RECEIVED.  EXIT  IMMEDIATELY 

250  CONTINUE 

CALL  EXIT 
END 
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CHAPTER  12 


THE  DCL  TASK 


The  DIGITAL  Command  Language 
language  syntax  implemented  on 


(DCL)  is  a  general  purpose  command 
several  DIGITAL  operating  systems. 


12.1  INTRODUCTION 

DCL  on  RSX-11M/M-PLUS  systems  is  a  task  that  receives  DCL  commands  by 
means  of  the  generalized  CLI  command  dispatcher,  translates  the  DCL 
commands  to  equivalent  MCR  commands,  and  sends  the  MCR  commands  to  the 
MCR  command  line  interpreter  for  interpretation  and  execution.  The 

con junction  with  the  CLI  dispatcher,  provides  DCL  support 
on  RSX-11M/M-PLUS  operating  systems. 


This  chapter  explains  the  ways  in  which  DCL  can  be  installed  on  your 
system  and  documents  the  means  by  which  the  DCL  task  parses  and 
ranslates  commands.  In  addition,  this  chapter  documents  the  Macro 
MetaLanguage,  a  set  of  MACRO-11  macros  used  to  define  DCL.  An 
experienced  programmer  can  add  commands  to  DCL  or  remove  them,  or 
alter  DCL  by  changing  parts  of  it,  such  as  altering  defaults  or 
eliminating  qualifiers . 

For  information  on  DCL  syntax  and  functions,  see  the  RSX-11M  Command 
Language  Manual  or  the  RSX- 1 1 M- PLUS  Command  Language  Manual^  For 
information  on  MCR  syntax  and  functions,  see  the  RSX-11M/M-PLUS  MCR 
Operations  Manual .  For  information  on  the  CLI  command  dispatcher,  and 
on  alternate  CLIs,  see  Chapter  11,  Command  Line  Interpreters,  in  this 
manual.  For  information  on  the  Executive  directives  used  to  implement 
alternate  CLIs,  see  the  RSX-11M/M-PLUS  and  Micro/RSX  Executive 


The  examples  of  source  code  in  this  chapter  illustrate  features  of  DCL 
and  the  DCL  task,  but  they  are  often  changed  from  the  actual  source 
co  e  to  make  the  example  clearer.  See  the  DCL  source  code  in  [23,10] 
tor  exact  information.  The  command  tables  for  the  ASSIGN  command  are 
included  in  this  chapter  (Section  12.11.6)  as  a  general  example  of  DCL 


12.2  INSTALLING  AND  BUILDING  DCL 

The  DCL  task  is  best  installed  as  an  alternate  CLI,  but  it  can  also  be 
run  as  a  task  or  installed  as  an  external  MCR  task.  External  MCR 
tasks  have  task  names  in  the  form  ...abc.  Furthermore,  you  can 
rebuild  DCL  either  to  eliminate  direct  access  to  MCR  from  DCL,  or  to 
allow  all  commands  not  in  DCL  syntax  to  fall  through  DCL  for  handling 
by  MCR.  Your  choice  on  these  options  depends  on  the  requirements  of 
your  system  users  and  your  installation. 
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12.2.1  Conventional  Installation  of  DCL  as  a  CLI 

Installing  DCL  as  an  alternate  CLI  is  the  cleanest  use  of  DCL.  This 
allows  you  to  classify  users  by  CLI  in  the  system  account  file.  Users 
can  log  in  using  either  HELLO  or  LOGIN.  The  HELLO  task  checks  the 
account  file  for  the  CLI  and  sets  the  user's  terminal  to  the 
designated  CLI. 

On  RSX-11M  systems ,  DCL  and  alternate  CLI  support  require  a  mapped 
system  with  multiuser  protection.  If  you  choose  DCL  at  system 
generation ,  you  are  also  choosing  alternate  CLI  support,  as  DCL  is  an 
alternate  CLI.  In  addition,  choosing  DCL  support  also  gives  you 
support  for  the  following  directives  2 

•  Stop-bit 

•  Install-request-remove 

•  Parent-offspring  tasking  with  chaining 

•  AST 

•  Specify  request  exit  AST 

•  Get  task  parameters 

•  Get  command  for  command  interpreter 

•  Request  and  pass  offspring  information 

•  Specify  command  arrival  AST 

•  Get  command  interpreter  information 

The  last  four  directives  listed  are  those  specifically  added  for 
alternate  CLI  support.  See  Chapter  11,  "Command  Line  Interpreters," 
and  the  RSX-11M/M-PLUS  and  Micro/RSX  Executive  Reference  Manual. 

During  system  generation  on  RSX-11M-PLUS ,  you  are  asked  if  you  want 
alternate  CLI  support  or  DCL  support.  The  other  (non-CLl)  directives 
listed  above  are  supported  on  all  RSX-11M-PLUS  systems  with  the 
full-function  Executive. 

Installing  DCL  as  an  alternate  CLI  on  either  RSX-11M  or  RSX-11M-PLUS , 
requires  only  two  commands : 

MCR> INSTALL  $OCL.TSK/CLI=YES 
MCFOCL.I  /INIT  =  IiCL 

When  you  choose  DCL  support  during  system  generation,  the  INSTALL 
command  is  issued  in  the  SYSVMR  portion  of  system  generation.  You 
must  also  include  the  CLI  /INIT  command  in  the  system  STARTUP . CMD 
file. 


12.2.2  Alternative  Ways  to  Use  DCL 

If,  for  some  reason,  you  choose  not  to  have  alternate  CLI  support,  you 
can  still  use  many  of  the  features  of  DCL  by  taking  advantage  of 
alternative  ways  of  installing  DCL.  You  can  run  DCL  as  a  task, 
install  DCL  as  an  external  MCR  task  under  the  name  ...DCL,  or  install 
DCL  as  the  system  catchall  task  under  the  name  ...CA. 
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If  DCL  is  not  a  CLI ,  you  cannot  log  in  with  the  LOGIN  command,  you 
cannot  change  your  defaults  with  the  SET  DEFAULT  command,  breakthrough 
writes  do  not  break  through,  and  spawned  tasks  are  not  renamed  (that 
is,  a  DIRECTORY  command  spawns  a  task  named  PIPTnn,  not  DIRTnn) . 


12.2.2.1  Run  DCL  as  a  Task  -  If  you  wish,  you  can  simply  run  DCL  as  a 
task.  If  you  place  the  task  image  file  in  the  system  directory  on 
RSX-11M  or  the  library  directory  on  RSX-11M-PLUS ,  users  can  run  DCL 
with  the  command: 

> RUN  $DCL 

DCL  runs  from  your  terminal  as  a  task.  The  terminal  remains  set  to 
MCR.  All  DCL  commands  work  in  the  normal  way,  but  a  carriage  return 
on  a  line  by  itself  causes  the  task  to  exit. 


12.2.2.2  Install  as  ...DCL  -  If  you  install  the  DCL  task  as  an 
external  MCR  task  under  the  name  ...DCL,  users  can  issue  DCL  commands 
from  an  MCR  terminal  simply  by  preceding  the  command  with  DCL,  as  in 
the  following  example: 

MCR>DCL.  SHOW  USFRS 


12.2.2.3  Install  as  • • »CA.  —  If  you  install  the  DCL  task  under  the 
name  ...CA.,  all  commands  not  recognized  by  MCR  are  handled  by  DCL 
running  as  the  catchall  task.  This  means  that  DCL  commands  such  as 
MOUNT  and  SET  that  are  identical  with  MCR  commands  in  the  first  three 
characters  must  be  in  MCR  syntax.  These  commands  in  DCL  syntax  are 
recognized  by  MCR,  but  only  as  errors.  To  avoid  infinite  loops,  the 
DCL  installed  as  MCR ' s  catchall  must  not  be  built  with  MCR  as  its 
catchall . 


12.2.3  The  MCR  Command 

The  MCR  command  is  included  in  the  default  DCL  task.  This  command 
permits  users  to  issue  a  one-line  MCR  command  without  leaving  DCL. 
The  MCR  command  is  not  affected  by  SET  DEBUG. 

Some  installations  may  prefer  not  to  permit  DCL  users  any  access  to 
MCR.  If  you  wish  to  restrict  access  to  MCR,  you  must  modify 
DCLBLD.CMD  following  the  instructions  contained  therein  and  then 
rebuild  DCL. 


12.2.4  DCL  SET  Commands  from  MCR 

All  DCL  SET  commands  may  be  used  from  MCR.  MCR  has  been  modified  to 
pass  all  SET  commands  that  do  not  have  a  slash  in  front  of  the  keyword 
to  DCL. 
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12.2.5  Allowing  Unrecognized  Commands  to  Fall  Through  to  MCR 

The  default  DCL  task  returns  an  error  for  any  command  not  recognized 
as  a  DCL  command.  You  may  prefer  that  DCL  allow  any  unrecognized 
commands  to  fall  through  to  MCR  for  another  chance  at  execution.  This 
permits  users  direct  access  to  MCR  tasks  and  utilities  without  using 
the  MCR  command  or  the  RUN  command. 

If  you  wish  to  allow  commands  to  fall  through  DCL  to  MCR,  modify 
DCLBLD.CMD  following  the  instructions  contained  therein  and  then 
rebuild  DCL. 


12.2.6  Flying  Installs 

Tasks  need  not  be  installed  for  DCL  to  access  them.  Comments  in 
DCLBLD.CMD  explain  how  to  enable  flying  installation  of  tasks.  Again, 
modify  DCLBLD.CMD  and  rebuild  DCL. 


12.2.7  Task  Building  DCL 

All  of  the  changes  to  DCL  described  in  this  chapter  require  that  the 
DCL  task  be  rebuilt.  The  overlay  structure  of  the  DCL  task  forces  a 
complex  task  build  that  actually  requires  two  passes  by  the  Task 
Builder  before  it  is  complete.  The  first  pass  creates  a  symbol  table 
(.STB  file)  that  is  used  by  TKB  on  the  second  pass  to  build  the  DCL 
task.  The  following  two  sections  summarize  the  task-build  process. 

NOTE 

The  file  [ 1 , 24 ]DCLBLD . CMD  is  called  by  SYSGEN  when  you 
request  DCL  support.  You  should  read  this  file  before 
attempting  to  task  build  DCL. 


12.2.7.1  Summary  of  First  Task  Build  -  The  following  summarizes  the 
first  task  build  process: 

•  Each  DCL  command  is  defined  in  a  parser  table  (or  PT )  that 

defines  the  DCL  syntax  of  the  command. 

•  The  PT  is  paired  with  a  translator  table,  or  TT,  which  defines 
the  MCR  equivalents  for  the  DCL  command. 

•  The  addresses  of  the  PT  and  TT  are  included  in  a  master 

command  table  (MCT)  that  lists  all  DCL  commands. 

•  When  DCL  parses  a  command,  it  seeks  the  address  of  that 

command  in  the  MCT  and  then  goes  to  that  address  for 

translation  of  the  command  to  MCR  at  the  PT/TT. 

•  The  parser  tables  and  translator  tables  are  overlaid  on  the 

master  command  table;  this  means  that  at  the  time  of  the  first 
task  build,  the  master  command  table  entries  are  undefined 
symbols . 

The  first  task  build  uses  a  command  in  the  following  form: 

>TKB  *  ? DCL  * STB=RCL 

This  results  in  one  or  more  undefined  symbols  for  each  command,  but 
the  PT/TT  addresses  for  each  command  are  in  the  .STB  file. 


12-4 


THE  DCL  TASK 


12.2.7.2  Summary  of  Second  Task  Build  -  The  following  summarizes  the 
second  task  build  process: 

•  The  master  command  table  symbols  are  defined  by  means  of  the 
.STB 

•  The  addresses  in  the  PT/TT  are  doubly  defined,  once  in  the 
.STB  and  once  in  their  overlays.  The  two  definitions  are 
identical.  In  fact,  this  process  is  accomplished  through  two 
•ODL  files.  See  DCLBLD.CMD  for  more  information. 

The  second  task  build  uses  a  command  in  the  following  form: 

>  TKB  DCL  j r DCL-DCLr DCL ♦ STB 


12.2.8  How  the  DCL  Task  Works 

This  section  describes  how  DCL  commands  are  interpreted  and  provides 
an  overview  of  how  DCL  command  tables  are  constructed. 


12.2.8.1  Interpreting  DCL  Commands  —  There  are  three  processes 
involved  in  interpreting  DCL  commands  —  the  receive  process,  the 
parser/translator  process,  and  the  send  process.  The  receive  process 
gets  the  command  line  from  the  system.  The  table-driven 
parser/translator  process  translates  the  command  line  to  an  equivalent 
MCR  command  line.  The  send  process  sends  the  equivalent  MCR  command 
line  to  the  system  for  further  interpretation  and  execution.  These 
processes  are  further  described  as  follows: 

•  The  receive  process  involves  two  tasks:  the  CLI  dispatcher 

task  (MCR...)  and  the  DCL  task  (...DCL).  The  CLI  dispatcher 
task  gets  the  command  line  from  the  terminal  driver,  queues  it 
to  a  CLI  queue,  and  activates  the  DCL  task  (if  not  already 
active) .  The  DCL  task  activated  is  named  DCLTnn,  where  nn  is 
the  number  of  the  issuing  terminal.  The  DCL  task  (being 
nonprivileged )  issues  the  Get  Command  for  Command  Interpreter 
(GCCI$)  directive  to  remove  (or  receive)  the  command  line  from 
the  CLI  queue . 

•  The  parser/translator  process  involves  two  subprocesses:  the 

parser  process  and  the  translator  process.  The  parser  process 
checks  syntax  to  ensure  that  the  received  command  line  is  a 
valid  DCL  command  line.  The  parser  constructs  an  intermediate 
form  (/FORM)  to  pass  data  about  the  command  line  to  the 
translator.  The  translator  process  uses  this  data  to 
construct  an  equivalent  MCR  command  line  from  the  valid  DCL 
command  line. 

•  The  send  process  dispatches  the  equivalent  MCR  command  line  to 
MCR  or  MCR  utility  tasks  by  means  of  the  Request  and  Pass 
Offspring  Information  (RPOI$)  directive.  The  RPOI$  directive 
is  functionally  similar  to  the  SPWN$  directive.  There  are  two 
significant  differences  from  SPWN$ :  RPOI$  allows  the  spawned 
task  to  be  named  (for  example,  spawn  PIP  and  name  it  COPTnn) , 
and  RPOI$  does  not  create  OCBs  (Offspring  Control  Blocks). 
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The  DCL  task  needs  the  task-naming  ability  to  track  the  association 
between  the  DCL  command  name  and  the  MCR  or  utility  task  that  executes 
the  command.  And,  instead  of  creating  an  OCB,  RPOI$  takes  the  OCB 
attached  to  the  DCL  task  and  attaches  this  OCB  to  the  spawned  task. 
This  enables  the  spawned  task  to  communicate  exit  status  directly  to 
the  parent  task,  DCL.  In  this  way,  the  DCL  task  can  spawn  a  task 
without  having  to  wait  for  the  task  to  exit. 


12.2.8.2  Constructing  DCL  Command  Tables  -  The  remainder  of  this 
chapter  describes  how  to  construct  the  DCL  command  tables,  which  drive 
the  parser/ translator  process.  Basically,  the  tables  contain  the 
following  for  each  DCL  command: 

•  The  syntax  of  the  DCL  command 

•  The  syntax  of  the  equivalent  MCR  command  (that  is,  the  syntax 
of  the  MCR  command  that  the  DCL  command  translates  to) 

•  The  relationship  (or  mapping)  between  the  DCL  syntax  and  the 
MCR  syntax. 

MACRO-11  macros  and  rules  define  the  tables.  The  macros  and  rules 
form  a  language  designed  to  allow  the  user  to  express  the  tables. 

The  macros  and  rules  are  called  the  Macro  MetaLanguage  (MML) .  Here  is 
a  list  of  some  of  the  features  of  the  language  and  how  they  are 
employed  in  the  DCL  task : 

•  MML  is  modeled  after  a  Backus-Naur  Form  ( BNF )  metalanguage.  A 
BNF  language  specifies  which  sequences  of  symbols  constitute  a 
syntactically  valid  statement  in  a  given  language.  In  this 
case,  MML  is  used  to  describe  the  proper  syntax  of  a  DCL 
command  and  the  equivalent  syntax  of  an  MCR  command. 

•  MML  allows  the  specification  of  a  prompt  string  for  each 
syntax  element.  DCL  prompts  for  more  input,  with  the 
specified  string,  if  a  test  for  end-of-line  is  successful. 

•  MML  interfaces  with  the  RSX-11M/M-PLUS  HELP  utility.  The  user 
requests  help  by  typing  a  "?"  character  in  reply  to  a  prompt. 

•  MML  allows  the  specification  of  an  error  message  string  for 
each  syntax  element.  If  DCL  detects  an  error  while  processing 
a  syntax  element  and  that  syntax  element  has  a  specified  error 
message,  DCL  issues  the  error  message  and  aborts  the  parse. 

•  MML  allows  the  specification  of  contradictory  bit  masks  for 
each  syntax  element.  DCL  uses  the  bit  masks  to  detect 
contradictory  syntax. 

•  MML  allows  the  use  of  globally  defined  syntax  elements,  such 
as  file  specifications,  device  specs,  numerals,  letters, 
alphanumerics  and  so  forth. 

•  MML  allows  MACRO-11  Assembly  Language  subroutines  to  be  mixed 
with  MML  statements  in  the  event  that  a  command  cannot  be 
completely  defined  using  MML. 
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•  MML  allows  one  DCL  command  to  translate  to  more  than  one  MCR 
command.  For  instance,  the  DCL  SET  DEFAULT  command  can 
generate  both  an  MCR  ASN  command  and  an  MCR  SET  /UIC  command . 

•  MML  supports  floating  qualifiers.  A  floating  qualifier  can  be 
specified  anywhere  in  the  command  line. 

The  following  section  describes  the  DCL  command  tables.  The  DCL 
command  tables  define  all  DCL  commands  and  are  written  in  MML.  See 
Sections  12.6  through  12.10  for  more  information  on  MML. 


12.3  DCL  COMMAND  TABLES 

The  parser/translator  process  of  DCL  is  table-driven.  A  master 
command  table  (MCT)  contains  an  entry  for  each  DCL  command.  Each 
entry  in  the  MCT  contains  the  following: 

•  The  name  (verb)  of  the  command 

•  The  address  of  a  parser  table  (PT)  for  the  command 

•  The  address  of  a  translator  table  (TT)  for  the  command 

•  The  name  of  the  overlay  containing  the  PT  and  the  TT 
(optional) 

Thus,  there  is  a  PT  and  a  TT  for  each  DCL  command.  Each  PT/TT 
contains  the  information  that  the  parser/translator  process  needs  to 
translate  a  DCL  command  line  to  an  equivalent  MCR  command  line.  For 
ease  in  adding  and  modifying  commands,  MCT  and  each  PT/TT  are  kept  in 
separate  files. 

The  file  for  the  MCT  is  called  COMMAND. MAC.  The  files  for  the  PT/TTs 
are  named  after  the  DCL  command,  with  the  type  .MAC.  For  example,  the 
PT/TT  for  the  DCL  COPY  command  is  in  a  file  named  COPY. MAC. 

The  DCL  task  uses  MCT  to  recognize  an  arbitrary  command  and  to  locate 
the  PT/TT  for  that  command.  MCT  consists  of  calls  to  the  COMMAND 
macro.  There  is  a  COMMAND  macro  for  each  DCL  command.  Arguments  to  a 
COMMAND  macro  specify  the  name  (or  verb)  of  the  command,  the  address 
of  the  PT  for  the  command,  the  address  of  the  TT  for  the  command,  and 
the  overlay  name  for  the  command . 

The  PT/TTs  drive  the  parser/translator  process.  The  parser/translator 
process  ensures  that  the  syntax  of  the  DCL  command  line  is  correct  and 
creates  the  /FORM,  which  is  the  parser  subprocess,  and  subsequently 
constructs  equivalent  MCR  command  lines,  which  is  the  translator 
subprocess.  The  PT  drives  the  parser  subprocess  and  the  TT  drives  the 
translator  subprocess.  The  PT  is  an  MML  definition  of  the  syntax  or 
structure  of  the  DCL  command  and  the  TT  is  an  MML  definition  of  the 
syntax  or  structure  of  the  corresponding  MCR  command. 

Table  12-1  shows  the  structure  of  the  DCL  command  table  files. 

The  PT  defines  the  syntax  for  a  DCL  command  line.  The  TT  defines  the 
syntax  for  the  corresponding  MCR  command  line.  For  the  translator  to 
know  which  particular  MCR  command  line  to  construct  from  a  particular 
DCL  command  line,  the  PT  and  the  TT  must  express  a  relation  between 
the  DCL  syntax  and  the  MCR  syntax . 
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Table  12-1 
DCL  Command  Tables 


COMMAND . MAC 

ABORT . MAC 

UNLOCK . MAC 

Master  Command  Table 

ABOPT : : 

UNLPT : : 

COMMAND  ABORT  ABOPT  ABOTT 
COMMAND  ASSIGN  ASSPT  ASSTT 

Parser 

Table 

Parser 

Table 

. 

ABOTT : : 

UNLTT : : 

COMMAND  UNLOCK  UNLPT  UNLTT 

Translator 

Table 

Translator 

Table 

The  PT/TT  expresses  this  relation  by  mapping  elements  from  DCL  syntax 
to  elements  in  MCR  syntax.  For  example,  the  DCL  qualifier  "/GLOBAL" 
maps  to  the  MCR  switch  "/GBL"  (that  is,  the  switch  /GBL  is  output 
when  the  qualifier  "/GLOBAL"  is  input). 

The  parser  passes  the  mapping  information  to  the  translator  by  means 
of  a  dynamic  data  structure  called  the  Intermediate  Form  ( IFORM) .  The 
parser  constructs  the  IFORM  and  the  translator  examines  the  IFORM. 
The  IFORM  contains  the  essential  information  that  the  translator  needs 
to  construct  the  equivalent  MCR  command  line .  Both  the  PT  and  the  TT 
define  the  mapping  from  DCL  to  MCR  syntax. 

The  Macro  MetaLanguage  (MML)  defines  the  PT  and  the  TT .  MML  is  a  set 
of  MACRO-11  macros  and  rules  implementing  a  language  in  which  a  user 
can  define  DCL  commands.  With  MML,  a  user  can  express  the  information 
in  the  PT  and  the  TT  in  a  BNF-type  metalanguage. 

The  following  section  describes  the  structure  of  the  file  that 
contains  the  MCT  and  of  the  files  that  contain  the  PT/TTs .  It  also 
describes  how  these  files  assemble,  overlay,  and  task  build  into  the 
DCL  task.  Section  12.4.1.1  describes  how  to  create  the  PTs  and  TTs . 


12.4  MODIFYING  DCL  COMMAND  TABLES 

A  DCL  command  consists  of  an  entry  in  the  master  command  table  (MCT), 
a  parser  table  (PT),  and  a  translator  table  (TT) .  The  PT  defines  the 
syntax  of  the  DCL  command.  The  TT  defines  the  syntax  of  the 
corresponding  MCR  command.  The  entry  in  the  MCT  connects  the  PT  and 
the  TT  to  the  DCL  task.  Thus,  to  add  a  new  command  to  the  DCL  task, 
the  user  must  construct  a  PT  and  a  TT  and  make  an  entry  in  the  MCT. 


12.4.1  Adding  Commands 

Adding  a  command  to  the  DCL  task  involves  the  following: 

1 .  Creating  the  PT  and  the  TT 

2.  Creating  the  file  that  contains  the  PT  and  the  TT 
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3. 

4. 


Making  an  entry  in  the  MCT 

Making  an  entry  in  the  overlay  description  file  for  the  DCL 
task 

Incorporating  the  new  PT/TT  file  and  the  modified  MCT  file 
into  the  DCL  task 


named 1,1  The  fT/TT  File  -  The  file  that  contains  the  PT  and  the  TT  is 
named  after  the  verb  of  the  command.  The  file  type  is  MAC  (for 

rnpv^a^ thS  PTl,and  tbe  TT  for  the  COPY  command  are  in  a  file  named 
COPY. MAC) .  The  PT/TT  file  must  specify  the  MACRO-11  assembly 
directives  .TITLE,  .PSECT,  and  .END.  The  title  of  the  file  (specified 

verb3of  !?gument  the  •TITLE  directive)  must  also  be  the  same  as  the 
w1_.k  f  tb  command.  Normally,  the  program-section  name  is  . CDEF, 
which  stands  for  command  definition.  If,  however,  MACRO-11 
oredef^n11^8  are  interspersed  with  MML  notation  by  means  of  the  $JSR 
p  edefined  syntax  element,  the  subroutines  must  be  in  the  blank 
program  section.  (See  Section  12.11  for  details  on  $JSR. ) 

(MACRO-llT  directives,  the  PT/TT  file  must  contain  a 

(MACRO  11)  global  label  on  the  first  MML  macro  of  the  PT  and  a  global 

he  flrSt  MML  maCr°  °f  the  TT*  BY  convention,  the  label  on 

mm  •  the  SamS  aS  the  Verb  of  the  DCh  command,  and  the  label  on 

the  TT  is  the  same  as  the  verb  on  the  corresponding  MCR  command.  The 

foilowing  shows  the  structure  of  the  file  that  contains  the  PT  and  the 
TT  for  the  DCL  ASSIGN  command: 


ASSIGN. MAC 


.TITLE 

ASSIGN 

.PSECT 

.CDEF 

ASSIGN: : 

Parser 

Table 

ASN :  : 

Translator  Table 

.END 

The  two  global  labels  in  the  PT/TT  file  connect  the  PT  and  the  TT 
the  DCL  task.  This  is  accomplished  by  making  an  entry  in  the  MCT. 


to 


12'4‘!U2  The  MCT  Entry  -  The  file  COMMAND. MAC  contains  the  master 
command  table  (MCT).  The  MCT  consists  of  a  list  of  (MACRO-11)  COMMAND 
macrocalls.  Each  COMMAND  macrocall  identifies  a  DCL  command.  The 
llsb  °J  C°MMAND  macrocalls  is  ordered  alphabetically  by  the  name  or 
verb  of  the  command.  The  COMMAND  macro  takes  five  arguments.  The 

arS  ™andatorY  and  the  fifth  is  optional.  The  format  for 
the  COMMAND  macro  is  as  follows: 


COMMAND 


where : 


name,  min,  ptaddr,  ttaddr,  [ovrnam] 


name 

min 


Name  or  verb  of  the  command 

Minimum  number  of  characters  necessary  to  make  the  name 
unique 
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ptaddr  Label  of  the  PT  for  the  command 
ttaddr  Label  of  the  TT  for  the  command 


[ovrnam]  Three-character  name  of  the  overlay  for  the  PT  and  TT 

The  fifth  argument  to  the  COMMAND  macro  (ovrnam)  is  optional.  The  PT 
and  TT  must,  however,  be  in  an  overlay  whether  or  not  you  specify  this 
araument.  The  default  overlay  name  is  the  command  verb,  assuming  the 
PT  and  TT  are  in  the  same  module.  If  they  are  in  separate  modules, 

the  PT  overlay  is  named  for  the  verb  by  default,  and  the  TT  is  named 

for  the  verb  preceded  by  a  "T"  (for  example,  TSET.MAC) . 

The  MCT  is  in  two  parts.  Part  1  of  the  MCT  includes  all  DCL  command 
verbs  in  alphabetical  order,  as  described  in  this  section.  J^rt  1  is 
searched  with  a  binary  search  algorithm.  Part  2  of  the  MCT  make 
possible  the  brief  forms  of  commonly  used  DCL  commands .  If  the  search 
of  Part  1  for  a  command  verb  fails  —  if  a  line  is  too  short,  for 

instance  —  a  search  of  Part  2  is  initiated.  Part  2  1S  not 

necessarily  in  alphabetical  order  as  it  is  searched  from  the  top  down. 


12.4.1.3  The  Overlay  Entry  -  Each  PT/TT  must  reside  in  an  overlay. 
Use  one  of  the  following  structures  to  overlay  a  PT/TT: 

•  One  overlay  for  two  or  more  PT/TTs 

•  One  overlay  for  one  PT/TT 

•  Two  overlays  for  one  PT/TT 

•  More  than  two  overlays  for  one  PT/TT 

Specify  an  overlay  by  making  an  entry  in  the  overlay  description  files 

_  DCLBLD . ODL  and  DCDBLD.ODL  —  and  connect  the  new  overlay  entry  to 

the  root  segment  overlay  entry. 

One  Overlay  for  Two  or  More  PT/TTs 

The  format  for  this  overlay  entry  is  as  follows: 


label : 
where : 
label 
ovrnam 
DCLO 
cmdnaml 
cmdnam2 


. NAME  ovrnam 

■ FCTR  ovrnam— DCLO/LB : cmdnaml : cmdnam2 • . . :cmdnamn— L 

Connects  the  entry  to  the  root  segment 
Three-character  name  of  the  overlay 

Object  library  containing  the  modules  in  the  overlays 
Title  of  the  file  containing  the  first  PT/TT 
Title  of  the  file  containing  the  second  PT/TT 


cmdnamn  Title  of  the  file  containing  the  last  PT/TT 

For  each  entry  in  the  MCT  whose  command  tables  (PT/TTs)  are  in  an 
overlay  that  has  two  or  more  PT/TTs,  you  must  include  the  overlay 
name,  ovrnam. 
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One  Overlay  for  One  PT/TT 


The  format  for  this  overlay  entry  is  as  follows: 
label:  .FCTR  DCLO/LB : cmdnam-L 


where : 
label 
cmdnam 


Connects  the  entry  to  the  root  segment 
Title  of  the  file  that  contains  the  PT/TT 


This  structure,  one  overlay  and  one  PT/TT,  does  not  specify  the 

I  nam?i:  In  this  Case'  the  DCL  task  uses  the  name  or  verb  of  the 
command  as  the  overlay  name  because  the  Task  Builder  default  for  the 

overlay  name  is  the  title  of  the  file.  For  this  reason?  the  title  o? 
Se6  co^and?tainin9  PT/TT  be  thS  ™  or  ve^  3 


Two  Overlays  for  One  PT/TT 


The  format  for  this  overlay  entry  is  as  follows: 

label :  . FCTR  ( DCLO/LB : cmdnam-L , DCLO/LB : tcmdnam-L ) 

where : 


label  Connects  the  entry  to  the  root  segment 

cmdnam  Title  of  the  file  that  contains  the  PT 

tcmdnam  Title  of  the  file  that  contains  the  TT 

Note  that  this  overlay  structure,  two  overlays  and  one  PT/TT,  requires 
that  the  PT  and  TT  reside  in  separate  files.  The  separate  files  have 
the  same  format  as  a  single  file  that  contains  the  PT/TT  except  that 
there  is  only  one  global  label  in  each  file.  By  convention,  the  file 
containing  the  PT  is  named  for  the  verb  of  the  command  and  the  file 
containing  the  TT  is  named  for  the  verb  prefixed  by  "T" .  The  titles 
of  the  files  follow  the  same  convention.  For  example  the  file 
containing  the  PT  for  the  DCL  SET  command  is  named  SET. MAC  with  title 

HI'  file  containing  the  TT  for  the  DCL  SET  command  is  named 

TSET . MAC  with  title  TSET . 


More  than  Two  Overlays  for  One  PT/TT 


The  format  for  this  overlay  entry  is  as  follows: 
label:  .FCTR 

( DCLO/LB : cmdnam-L , DCLO/LB : tcmdnam-L , DCLO /LB : ovrnaml -L ) 


where: 

label 

cmdnam 

tcmdnam 


Connects  the  entry  to  the  root  segment 
Title  of  the  file  that  contains  the  PT 
Title  of  the  file  that  contains  the  TT 


ovrnaml  Title  of  a  file  containing  more  parts  of  the  PT/TT 


Basically,  the  overlay  structure  of  more  than  two  overlays 
single  PT/TT  allows  a  PT  or  a  TT  to  invoke  additional 
containing  additional  portions  of  the  PT  or  TT.  Since  the  PT 


and  a 
overlays 
and  TT 
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are  read-only  data,  the  additional  overlay  segments  are  loaded  on  top 
of  t^  overlay  thai  is  invoking  them.  On  return  from  the  xnvoked 
overlay,  the  DCL  task  reloads  the  previous  overlay.  Control  returns 
to  the  point  in  the  previous  overlay  whence  the  additional  overlay  was 

invoked. 

Use  the  $CALLOV  predefined  syntax  element  to  invoke  additional 
overlays  from  a  PT  or  a  TT.  (See  Section  12.11,  for  details  on  the 
$CALLOV  predefined  syntax  element.)  To  specify  additional  overlays, 
repeat  the  previous  format.  That  is,  for  each  additional  overlay, 
specify  an  additional  argument  to  the  . FCTR  directive  using  t.  e 
format:  DCLO/LB :ovrnam-L . 

Next,  connect  the  new  overlay  entry  to  the  root  segment  of  the  DCL 
task  by  adding  the  label  of  the  entry  to  the  list  of  labels  for  other 
entries.  The  list  of  labels  for  other  entries  is  found  in  the  overlay 
description  file  after  the  label  OLAY.  By  convention,  enter  the 
labels  in  alphabetical  order.  The  following  shows  the  list  of  overlay 
entry  labels: 

OLAY:  .FCTR  ( 11 , 12 , 13 , 14 , 15 , . . . , In) 


where : 


11 , . . . , In  Labels  of  overlay  entries 

Note  that  since  there  are  two  overlay  description  files  for  building 
the  DCL  task  ( DCLBLD . ODL  and  DCDBLD . ODL ) ,  you  must  make  new  overlay 
entries  in  both  files.  The  format  is  the  same  for  both  overlay 
description  files.  For  details  on  how  to  build  the  DCL  task,  see 
Section  12.2.  For  details  on  overlay  structures,  see  the 
RSX-11M/M-PLUS  Task  Builder  Manual . 

The  last  step  required  to  add  a  command  to  the  DCL  task  is  to 
incorporate  all  created  or  modified  files  into  the  DCL  task,  as 
described  in  the  following  section. 


12.4.1.4  Incorporating  the  PT/TT  and  MCT  -  The  last  step  in  adding 
new  commands  to  DCL  —  assembly  and  task  building  --  is  accomplished 
through  the  indirect  command  file  [23 , 24]DCL.CMD,  which  is  on  the  same 
disk  as  the  DCL  sources.  This  file  prompts  for  the  name  of  a  file 
containing  the  names  of  all  modules  you  have  changed  or  created.  The 
input  file  consists  of  one  module  name  per  line,  with  no  file  type  or 
version  number.  DCL.CMD  then  assembles  the  modules,  updates  the 
object  libraries,  and  task  builds  the  new  version  of  DCL. 

Invoke  DCL.CMD  as  follows: 

>  6 DCL 

t  D  o  v.<  o  u  w  a  n  t  e  x  p  a  n  d  e  d  e  o  its  m  e  n  t  s  ?  T  Y  /  N  .1 1 

Answer  Y  to  this  question.  The  comments  in  DCL.CMD  direct  the 
remainder  of  the  process . 

If  all  source  files  assemble  correctly,  DCL.CMD  then  builds  the  DCL 
task.  See  Section  12.2  for  information  on  how  to  determine  if  the  DCL 
task  was  built  correctly  and  for  information  on  how  to  install  DCL  as 
a  CLI  in  a  multi-CLI  environment. 

The  DCL.CMD  command  file  is  designed  to  run  under  MCR  with  MAC,  LBR, 
PIP,  and  TKB  installed.  DCL.CMD  is  also  designed  to  run  using  one 
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UFD:  the  one  that  you  invoke  the  command  file  from.  This  means  that 

the  following  files  must  be  in  this  UFD: 

•  Specified  source  files 

•  Library  files  for  DCL:  DCLO.OLB  and  DCLR.OLB  (the  overlay  and 
root,  respectively) 

•  Prefix  files  for  DCL:  DCLMAC . MAC  and  COMMAC.MAC 

•  Task-build  command  file:  DCLBLD.CMD 

•  Overlay  description  files:  DCLBLD.ODL  and  DCDBLD.ODL 

Additionally,  RSXMC.MAC  must  be  in  LB: [11,10].  Although  DCL  is 
nonpr ivileged ,  DCL  needs  this  file  to  determine,  at  assembly  time, 
whether  your  system  is  RSX-11M  or  RSX-11M-PLUS . 


12.4.2  Deleting  Commands 

To  delete  a  command  from  DCL,  you  must  break  the  link  between  the  MCT 
and  the  PT/TT.  To  do  this,  delete  the  appropriate  COMMAND  macro  entry 
m  the  MCT,  which  is  in  the  file  COMMAND. MAC.  Then,  incorporate  the 
modified  COMMAND. MAC  file  into  the  DCL  task  by  following  the  procedure 
outlined  in  the  preceding  section.  You  can  also  delete  the  entry  in 
the  overlay  description  files  and  the  object  modules  for  the  PT/TT  in 
the  DCLO.OLB  library,  but  this  is  optional. 


12.4.3  Modifying  Commands 

Modifying  an  existing  DCL  command  involves  modifying  the  PT/TT  files 
to  reflect  the  desired  change  and  incorporating  the  modified  files 
into  the  DCL  task,  as  described  in  Section  12.4.1. 

The  user  defines  DCL  PTs  and  TTs  using  MML.  The  following  section 
describes  a  metalanguage  in  general  terms,  using  a  simple  English 
sentence  as  the  example.  Following  the  introduction  of  these  general 
concepts  in  Section  12 . 5  is  a  more  detailed  explanation  of  the  Macro 
MetaLanguage  (MML)  itself  in  Section  12.6.  For  instance,  the  general 
introduction  in  Section  12.5  includes  a  description  of  ANDing  and 
ORing  in  metalanguages,  while  Section  12.6  describes  the  AND  and  OR 
macros  of  the  Macro  MetaLanguage . 


12.5  A  GENERAL  DESCRIPTION  OF  A  METALANGUAGE 

Consider  a  sentence  in  the  English  language.  A  syntax  tree  defines 
the  structure  or  syntax  of  a  sentence  as  shown  below: 


<sentence> 


<sub ject> 


<predicate> 


<article>  <adjective>  <noun>  <verb>  <direct  object> 


THE 


OLD 


MAN 


WALKED 


<article> 


<nounl > 


THE 


DOG 
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Note  that  the  sentence  "The  old  man  walked  the  dog"  is  one  of  many 
sentences  that  could  fit  the  above  structure  (syntax).  The  following 
description  of  the  syntax  tree  is  a  metalanguage  definition  of  the 
sentence : 


sentence 

:  :  = 

<subject>  <predicate> 

subject 

:  :  = 

<article>  <adjective>  <noun> 

predicate 

:  :  = 

<verb>  <direct  object> 

direct  object 

:  :  = 

<article>  <nounl> 

article 

:  :  = 

THE 

adjective 

:  :  = 

OLD 

noun 

:  :  = 

MAN 

verb 

:  :  = 

WALKED 

nounl 

:  :  = 

DOG 

Note  the  equivalence  of  the  metalanguage  definition  and  the  syntax 
tree.  They  describe  the  same  thing.  Note  also  that  the  metalanguage 
definition  uses  the  symbols  " < " ,  ">"#  and  "::=  . 

The  symbols  "<"  and  ">"  denote  category  references.  These  symbols 
enclose  the  name  of  the  category.  Categories  define  classes  of 
objects.  For  example,  the  category  <subject>  defines  English  words 
that  fit  the  structure  of  an  <article>  followed  by  an  <adjective> 
followed  by  a  <noun>. 

The  symbol  means  "is  defined  as"  and  denotes  a  production  rule. 

In  a  production  rule,  you  specify  the  category  name  to  the  left  of  the 
" symbol  and  the  definition  for  the  category  to  the  right  of  the 
symbol.  A  category  reference  means  there  is  a  production  rule 
for  the  category  that  requires  that  the  right  part  of  the  production 
rule  be  substituted  for  the  name  of  the  category.  For  example,  here 
is  the  production  rule  for  <subject>  that  references  the  category 
<ad jective> : 

subject  ::=  <article>  <adjective>  <noun> 

The  production  rule  for  the  category  <adjective>  is  as  follows: 
adjective  ::=  OLD 

Thus,  you  can  rewrite  the  production  rule  for  <subject>  as  follows, 
subject  : :=  <article>  OLD  <noun> 

Note  that  you  can  also  substitute  further  for  references  to  the 
categories  <article>  and  <noun>  to  produce  the  production  rule  as 
follows : 

subject  : :=  THE  OLD  MAN 

You  cannot  substitute  for  the  words:  THE,  OLD,  and  MAN.  These  words 
are  literal  strings.  For  simplicity,  literal  strings  are  called 
literals,  and  category  references  are  called  nonliterals.  A  category 
definition  (the  right  part  of  a  production  rule)  consists  of  literals 
or  nonliterals  (or  both)  concatenated  by  imp lied- AND s . 


12-14 


THE  DCL  TASK 


T£®i  •m^iedtND  ha!  n°.Symbo1  in  the  metalanguage  (thus  the  term 
implied).  Use  the  implied-AND  to  form  category  definitions  bv 

?°nC"-,ertlng  a^ltrary  numbers  of  syntax  elements.  A  syntax  element 

defint^on  %  llteral  °r  a  nonliteral.  For  example,  in  the  category 
definition  for  <sub3ect>  are  three  nonliterals  —  <article>; 

nonliterals '  aDd  <noun> .  An  implied-AND  concatenates  these 


Two  additional  notations  in  the  metalanguage  are  as  follows: 
Exclusive-OR  indicator  | 

Optional  syntax  indicators  [] 

Use  the  exclusive-OR  indicator  "I"  to  show  that  a  category  can  be 
defined  in  several  ways.  For  example,  here  is  the  production  rule  for 
the  category  <adjective>: 


adjective  : :=  OLD  I  YOUNG  I  MIDDLE-AGED 

When  substituting  for  a  nonliteral  with  more  than  one  definition 
(separated  by  "I"),  use  only  one  of  the  definitions  in  the 
substitution.  For  example,  substituting  for  the  nonliteral 
<adjective>  defined  in  this  way  in  the  production  rule  for  <subject> 
yields  one  of  the  following  three  production  rules: 

subject  ::=  THE  OLD  MAN 


or 


subject  ::=  THE  YOUNG  MAN 
or 

subject  ::=  THE  MIDDLE-AGED  MAN 

The  square  brackets,  "["  and  enclose  optional  syntax.  For 

example,  the  following  production  rule  defines  the  category  <subject>: 

subject  : :=  <article>  [  <adjective>  ]  <noun> 

The  square  brackets  around  the  nonliteral  <adjective>  indicate  that 
<ad jective>  is  optional  syntax.  This  would  allow,  by  means  of 
substitution,  rewriting  the  production  rule  for  <subject>  to  either  of 
the  following: 

subject  ::=  <article>  OLD  <noun> 


or 

subject  ::=  <article>  <noun> 

In  addition  to  denoting  optional  syntax,  the  square  brackets  also 
iteration.  That  is,  syntax  denoted  as  optional  can  also  be 
used  repeatedly  to  define  the  syntax.  For  example,  if  the  following 
defines  <adjective>: 

adjective  ::=  MEAN  I  OLD  |  FAT 

you  could  then  rewrite  the  production  rule  for  <subject>  (if  <subject> 
is  defined  with  "["  and  as  above)  to  the  following: 

subject  ::=  <article>  MEAN  OLD  FAT  <noun> 

Note,  the  repeated  substitution  for  the  nonliteral  <adjective>. 
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Thus ,  you  can  use  the  symbols,  rules,  and  logic  described  above  as  a 
language  (that  is,  as  a  metalanguage)  to  define  the  structure  of  other 
languages.  The  structure  or  syntax  of  a  language  is  called  the 
grammar  of  that  language.  The  grammar  is  used  to  determine 
mechanically  whether  an  arbitrary  sentence  is  a  sentence  in  the 
language . 

Our  interest  here  is  in  the  grammars  for  DCL  and  MCR,  the 
rSX-IIM/M-PLUS  command  languages.  Sentences  in  these  two  grammars  are 
called  commands.  Here  is  a  metalanguage  definition  for  the  grammar  of 
the  DCL  ASSIGN  command: 

assign  ::=  ASSIGN  [  /  <qual>  ]  <device>  <device> 

qual  ::=  LOCAL  I  LOGIN  I  GLOBAL  I  TERMINAL:  <device> 

Here  is  a  metalanguage  definition  for  the  grammar  of  the  MCR  ASN 
command : 

asn  ::=  ASN  <device>=<device>  [  /  <qual>  ] 

qual  ::=  LOGIN  I  GBL  I  TERM=  <device> 

The  following  section  describes  the  Macro  Metalanguage  (MML) .  MML 
implements  the  logic  of  the  metalanguage  above.  MML  defines  the 
grammars  for  the  DCL  and  MCR  command  languages.  Additionally,  MML 
expresses  the  mapping  from  DCL  grammar  to  semantically  equivalent  MCR 
grammar.  MML  provides  a  more  efficient  means  of  generating  (by  means 
of  the  MACRO-11  assembler)  the  data  structures  that  drive  the 
parser/translator  process  than  the  metalanguage  notation. 


12.6  THE  MACRO  METALANGUAGE 

The  Macro  MetaLanguage  (MML)  is  a  set  of  MACRO-11  macros  and  rules. 
The  following  describes  the  correspondence  of  the  metalanguage 
notation  presented  in  the  preceding  section  to  MML  notation. 

The  general  metalanguage  presented  in  the  preceding  section  supports 
two  logical  operators : 

•  implied-AND 

•  exclusive-OR 

The  Macro  MetaLanguage  has  two  MACRO-11  macros  to  correspond  to  these 
logical  operators: 

•  AND  macros 

•  OR  macros 

The  general  metalanguage  presented  in  the  previous  section  supports 
two  types  of  syntax  elements: 

•  literals 

•  nonliterals 

In  MML,  literals  and  nonliterals  are  presented  as  arguments  to  the  AND 
and  the  OR  macros . 
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In  MML,  literals  are  distinguished  from  nonliterals  by  makinq  the 
irst  character  a  quote  character  (for  example,  ’ASSIGN).  An  optional 
argument  that  you  can  specify  with  a  literal  is  the  abSrevUtilJ 
count.  The  abbreviation  count  is  a  numeral  that  indicates  the  minimum 
number  of  characters  that  the  parser  needs  to  match  for  a  successful 
parse .  For  example ,  you  could  rewrite 

’ASSIGN  —  to  —  < 'ASSIGN, 4> 

to  indicate  that  the  literal  "ASSIGN"  can  be  abbreviated  to  "ASSI " . 


NOTE 

The  use  of  the  symbols  " < "  and  ">"  indicates  (to 
MACRO-11)  that  the  argument  " 'ASSIGN, 4"  is  one 
argument  (not  two:  ASSIGN  and  4).  Do  not  confuse 
these  symbols  with  the  identical  metalanguage  symbols 
used  to  identify  nonliterals. 

In  the  general  metalanguage  presented  in  the  previous  section,  a 
noniiterai  is  a  reference  to  a  category.  You  define  a  category  with 
the  : symbol  by  specifying  the  name  of  the  category  to  the  left  of 
the  symbol  and  the  definition  for  the  category  to  the  riqht  of  the 


In  MML,  you  define  a  category  by  placing  a  MACRO-11  label  on  either 
the  AND  or  the  OR  macro.  The  label  is  the  name  of  the  category,  and 
the  arguments  to  the  macro  are  the  definition  for  the  category.  Thus, 
in  MML,  a  nonliteral  is  the  label  (of  an  AND  or  OR  macro)  that  you  use 
as  an  argument  to  an  AND  or  OR  macro. 

For  example,  the  metalanguage  notation  for  the  category  <qual>  is  as 
follows  : 


qual  ::=  GLOBAL  |  LOCAL  |  TERMINAL:  <device> 

The  equivalent  MML  notation  is  as  follows: 

QUAL:  OR  'GLOBAL  'LOCAL  TERM 

TERM:  AND  'TERMINAL:  $DEV 

There  are  two  categories:  QUAL  and  TERM.  There  are  three  category 

definitions  for  QUAL:  'GLOBAL,  'LOCAL,  or  TERM.  'GLOBAL  and  'LOCAL 

^re  literals  and  TERM  is  a  nonliteral.  The  category  definition  _ 

'TERMINAL:  $DEV  —  defines  the  category  TERM,  which  consists  of  a 

literal  'TERMINAL  and  a  predefined  nonliteral,  $DEV.  (See  Section 
12.11  for  a  description  of  $DEV) . 

Note  that  you  must  express  a  category  definition  like  'TERMINAL:  $DEV 
on  a  separate  line  (using  the  AND  macro)  because  an  argument  to  either 
the  AND  or  the  OR  macro  can  only  represent  one  syntax 
element  —  either  a  literal  or  a  nonliteral. 

Use  the  MML  notation  "OPT=T"  (optional=true)  to  indicate  that  syntax 
elements  are  optional.  This  notation  corresponds  to  the  metalanguage 
notation  "["  and  The  optional  syntax  notation  "OPT=T"  is  an 

attribute  of  syntax  elements  (literals  and  nonliterals).  You 
represent  literals  and  nonliterals  in  MML  notation  as  arguments  to  AND 
and  OR  macros.  Therefore,  you  specify  the  optional  syntax  indicator 
OPT-T  as  part  of  the  arguments . 
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To  specify  "OPT=T"  as  an  attribute  of  a  syntax  element,  enclose  the 
syntax  element  and  the  "OPT=T"  notation  in  angle  brackets .  For 
example,  to  specify  that  the  terminal  device  specification  ($DEV)  in 
the  previous  example  is  an  optional  syntax  element  (nonliteral) , 
rewrite  the  category  TERM  as  follows : 

TERM:  AND  'TERMINAL:  <$DEV  OPT=T> 

Use  the  "OPTR=T"  attribute  to  indicate  that  a  syntax  element  is 
optional  and  to  indicate  that  the  parser/translator  can  process  the 
syntax  element  repeatedly. 

The  notation  OPT  means  a  syntax  element  can  occur,  at  most,  one  time. 
The  notation  OPTR  means  a  syntax  element  can  occur  many  times.  In 
either  case,  the  element  can  occur  zero  times.  For  a  complete 
description,  see  Section  12.10. 

To  specify  an  arbitrary  number  of  arguments  for  the  AND  and  OR  macros, 
use  the  OR.,  AND.,  and  the  END  macros.  Use  the  AND.  and  OR.  macros 
as  continuation  markers  for  the  AND  and  OR  macros  respectively.  That 
is,  if  there  is  not  enough  space  on  the  line  for  all  the  arguments  to 
either  the  AND  or  OR  macros,  place  additional  arguments  on  the  next 
line.  To  do  this,  place  the  AND.  or  the  OR.  macro  on  the  next  line 
followed  by  the  continuation  of  the  specification  of  the  arguments. 
For  example,  you  could  rewrite  the  category  for  <qual>  to  the 
following : 

QUAL:  OR  'GLOBAL  'LOCAL 

OR.  TERM 
END 

Use  the  END  macro  to  indicate  the  end  of  the  specification  of  the 
arguments.  Note,  to  allow  this  continuation  ability  (without  any 
additional  overhead),  you  need  the  END  macro  whether  or  not  you  use 
the  continuation  ability.  For  example,  you  would  need  the  END  macro 
in  the  following  category  for  <qual>: 

QUAL:  OR  'GLOBAL  'LOCAL  TERM 

END 

Thus,  you  can  use  MML  like  the  metalanguage  of  the  general  description 
in  Section  12.5  to  define  the  syntax  of  a  DCL  command  and  the  syntax 
of  the  corresponding  MCR  command.  The  parser  table  (PT)  defines  the 
syntax  of  the  DCL  command  and  the  translator  table  (TT)  defines  the 
syntax  of  the  corresponding  MCR  command.  The  following  section 
describes  how  the  PT  and  TT  drive  the  parser/translator  process  (or 
how  the  parser  and  the  translator  interpret  the  PT  and  the  TT) . 


12.7  INTERPRETING  DCL  COMMAND  TABLES 

A  parser  table  (PT)  and  translator  table  (TT)  drive  the 
parser/translator  process.  There  is  a  PT/TT  for  each  DCL  command. 
The  PT  defines  the  DCL  syntax  and  the  TT  defines  the  corresponding  MCR 
syntax.  The  parser/translator  process  locates  the  PT  and  the  TT  for  a 
particular  DCL  command  line  by  searching  the  master  command  table 
(MCT )  for  the  command  entry.  The  parser/translator  extracts  from  the 
command  entry  the  address  of  the  first  AND  or  OR  macro  of  the  PT  and 
the  address  of  the  first  AND  or  OR  macro  of  the  TT. 
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12.7.1  Parser  Processing 

The  parser  starts  processing  at  the  address  of  the  first  macro  in  the 
•  If  the  processing  of  this  macro  succeeds,  then  the  parser  process 
succeeds.  A  successful  parser  process  means  that,  at  this  point,  the 
input  command  line  is  a  syntactically  correct  DCL  command  line  (as 
defined  by  the  PT )  and  the  intermediate  form  ( I FORM)  has  been 
constructed.  The  I FORM  is  a  condensed  representation  of  the  input 
command  line.  If  the  processing  of  this  macro  fails,  then  the  parser 
process  fails. 

The  parser  processes  the  AND  macro  by  processing  ( left— to— right)  each 
argument  (syntax  element)  of  the  AND  macro  until  either  all  arguments 
process  successfully  or  an  argument  is  encountered  that  does  not 
process  successfully.  if  all  arguments  process  successfully,  then  the 
processing  of  the  AND  macro  succeeds;  otherwise,  the  processing  of  the 
AND  macro  fails . 

The  parser  processes  the  OR  macro  by  processing  ( left-to-right)  each 
argument  (syntax  element)  of  the  OR  macro  until  either  the  parser 
successfully  processes  one  syntax  element  or  the  parser  fails  to 
process  any  of  the  syntax  elements.  If  the  parser  successfully 
processes  one  syntax  element,  then  the  processing  of  the  OR  macro 
succeeds;  otherwise,  the  processing  of  the  OR  macro  fails. 


12.7.2  Translator  Processing 

The  translator  starts  processing  at  the  address  of  the  first  macro  of 
the  TT.  If  the  processing  of  this  macro  succeeds,  then  the 
translation  succeeds  and  an  equivalent  MCR  command  line  (as  defined  by 
the  TT)  has  been  constructed  from  the  I FORM .  If  the  processing  of 
this  macro  fails,  then  the  translator  process  fails.  The  processing 
of  the  AND  and  OR  macros  by  the  translator  is  the  same  as  the 
processing  of  the  AND  and  OR  macros  by  the  parser  (as  described  in  the 
previous  section). 

Arguments  to  AND  and  OR  macros  can  be  literals  or  nonliterals. 
Nonliterals  are  handled  in  the  same  way  by  both  the  parser  and  the 
translator.  Literals,  however,  are  handled  differently  by  the  parser 
and  the  translator. 


12.7.3  Parser/Translator  Handling  of  Nonliterals 

Here  is  a  description  of  how  nonliterals  are  handled  by  both  the 
parser  and  the  translator. 

In  MML,  when  you  use  the  label  of  an  AND  or  OR  macro  as  the  argument 
to  an  AND  or  OR  macro  it  is  called  a  nonliteral;  thus,  a  nonliteral  is 
the  address  of  another  AND  or  OR  macro.  The  processing  of  a 
nonliteral  is  the  processing  of  the  other  AND  or  OR  macro  that  the 
nonliteral  addresses.  That  is,  when  the  parser  or  translator 
encounters  a  nonliteral  (as  an  argument  to  an  AND  or  OR  macro),  the 
parser  or  translator  transfers  parsing  or  translation  control  to  the 
macro  that  the  nonliteral  addresses .  The  addressed  macro  is  either  an 
AND  or  OR  macro  and  the  parser/translator  processes  this  macro  like 
all  AND  or  OR  macros  (as  described  in  the  previous  section).  If  the 
processing  of  this  macro  succeeds,  then  the  processing  of  the 
nonliteral  succeeds;  otherwise  the  processing  of  the  nonliteral  fails. 
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12.7.4  Parser/Translator  Handling  of  Literals 

Here  is  a  description  of  the  different  handling  of  literals  by  the 
parser  and  the  translator. 

A  string  of  ASCII  characters  used  as  an  argument  to  an  AND  or  OR  macro 
is  called  a  literal.  The  string  typically  is  a  keyword  in  the  DCL  or 
MCR  command  grammar.  The  parser  and  translator  process  literals 
differently. 

In  parsing  a  literal,  the  parser  attempts  to  match  the  literal  to  the 
input  DCL  command  line.  If  the  input  command  line  contains  the  same 
ASCII  string  as  the  literal,  then  the  match  is  successful  and  the 
processing  of  the  literal  succeeds?  otherwise,  nothing  happens. 

However,  in  translating  a  literal,  the  translator  copies  the  literal 
from  the  TT  to  the  MCR  command  line  buffer.  If  you  do  not  associate 
attributes  with  a  literal  in  a  TT,  then  the  processing  of  the  literal 
always  succeeds •  (Writing  a  literal  to  the  MCR  command  line  buffer 
always  succeeds.)  A  literal  in  a  TT  can  fail  only  if  you  have 
associated  one  of  the  following  attributes  with  the  literal: 

MAP,  CBM,  BCT ,  BST 

With  these  attributes  associated  with  a  literal,  the  translator 
processes  the  attributes  before  the  literal  is  written  to  the  MCR 
command  line  buffer. 

The  MAP  attribute  instructs  the  translator  to  check  for  a  mapping 
number  in  the  IFORM.  If  the  number  is  not  there,  the  translator  does 
not  write  the  literal  to  the  MCR  command  line  buffer  and  the 
processing  of  the  literal  fails . 

The  CBM,  BCT,  and  BST  attributes  instruct  the  translator  to  check  the 
status  of  certain  bits  in  its  internal  data  structures.  If  the  status 
of  the  bits  is  not  correct,  the  translator  does  not  write  the  literal 
to  the  MCR  command  line  buffer  and  the  processing  of  the  literal 
fails.  (See  Section  12.10  for  more  information  on  these  attributes). 


12.7.5  Summary  of  Parser/Translator  Functions 

In  summary,  the  parser  table  (PT)  drives  the  parser  and  the  translator 
table  (TT)  drives  the  translator.  The  parser/translator  succeeds  only 
if  the  processing  of  the  first  AND  or  OR  macro  of  the  PT/TT  succeeds. 
The  processing  of  an  AND  or  OR  macro  succeeds  only  when  the  processing 
of  the  arguments  to  the  macros  succeed.  Arguments  can  be  either 
literals  or  nonliterals.  A  nonliteral  instructs  the  parser/translator 
to  process  (recursively)  another  AND  or  OR  macro  and  succeeds  only  if 
the  subsequent  AND  or  OR  macro  succeeds .  A  literal  instructs  the 
parser  to  ensure  the  input  command  line  matches  the  literal  and 
succeeds  only  if  the  match  is  successful.  A  literal  instructs  the 
translator  to  output  the  literal  (possibly  conditionally)  to  the  MCR 
command  line  and  the  translator  succeeds  only  if  either  the  literal  is 
not  conditionalized  or  the  conditionals  are  satisfied. 
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12.7.6  Examples 

The  following  is  an  example  of  a  parser  table  (PT)  for  the  DCL  ASSIGN 
command. 

MML  NOTATION  for  PARSER  TABLE 


ASSIGN: : 

AND 

END 

'ASSIGN  <QUAL  OPTR=T>  $DEV 

QUAL: 

AND 

END 

’/  QUALI 

QUALI : 

OR 

< ’L0CAL,4> 

OR. 

< 'LOGIN, 4> 

OR. 

< 'GLOBAL, 2 > 

OR. 

END 

TERM 

TERM: 

AND 

END 

'TERMINAL:  <' TERMINAL, 4> ' : 

The  following  is  an  example  of  a  translator  table  (TT)  for  the  MCR  ASN 
command . 

MML  NOTATION  for  TRANSLATOR  TABLE 


ASN:  : 

AND 

END 

'ASN  $DEV  '= 

LAUQ  : 

OR 

' /LOGIN 

OR. 

'  /GBL 

OR. 

END 

MRET 

MRET : 

AND 

END 

’/TERM=  $dev 

These  examples  show  the  first  two  steps  you  must  follow  in  creating 
tables  for  the  DCL  ASSIGN  command.  The  last  step  is  to  express 
the  mapping  of  the  syntax  elements  in  the  PT  to  the  syntax  elements  in 
the  TT.  This  mapping  provides  the  information  that  the 
parser/translator  process  needs  to  construct  a  particular  MCR  ASN 
command  line  given  a  particular  DCL  ASSIGN  command  line.  The 
following  section  describes  how  to  express  this  mapping. 


12.8  MAPPING  DCL  TO  MCR 

The  mapping  of  a  given  DCL  command  line  to  the  equivalent  MCR  command 
line  is  accomplished  in  the  IFORM.  The  parser  processes  mapping 
information  and  records  it  in  the  IFORM.  The  translator  searches  the 
IFORM  for  mapping  information  and  then  generates  the  MCR  command  line. 

Mapping  information  is  expressed  in  MML  with  the  ,,MAP=n"  attribute. 
MAP  takes  one  or  two  values.  The  first  value  is  called  the  primary 
mapping  number.  The  second  value  is  called  the  secondary  mapping 
number.  If  you  need  only  the  primary  mapping  number,  specify  it  in 
the  following  form: 


MAP=n 
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If  you  need  to  specify  both  mapping  numbers,  which  is  allowed  only  in 
a  TT,  or  if  you  need  to  specify  only  the  second  number,  then  enclose 
the  numbers  in  angle  brackets  and  separate  them  with  a  comma  in  the 
following  form: 

MAP=<n,n>  or  MAP=< , n> 

To  associate  the  MAP  attribute  with  a  syntax  element,  enclose  the 
syntax  element  and  the  MAP  attribute  in  angle  brackets  as  follows: 

<  syntax-element  MAP=n> 

To  map  a  DCL  syntax  element  in  a  PT  to  an  MCR  syntax  element  in  the 
corresponding  TT,  use  MAP  with  the  same  mapping  number  for  both  syntax 
elements . 

For  example,  in  the  ASSIGN  command,  the  DCL  qualifier  "/GLOBAL"  maps 
to  the  MCR  qualifier  " /GBL" .  That  is,  when  the  DCL  qualifier 
"/GLOBAL"  is  input  (as  part  of  the  DCL  command  line),  the  MCR  switch 
"/GBL"  is  output  (as  part  of  the  MCR  command  line) . 

The  following  expresses  this  mapping  in  MML  notation  and  illustrates 
the  use  of  the  primary  MAP  number. 

QUAL:  OR  <’ /GLOBAL  MAP=1>  ... 

END 

LAUQ :  OR  < ' /GBL  MAP=1>  ... 

END 

MML  macros  at  QUAL:  define  DCL  syntax.  MML  macros  at  LAUQ:  (QUAL 
spelled  backwards)  define  the  corresponding  MCR  syntax.  When  the 
parser  reaches  QUAL:,  it  tries  to  match  the  literal  "/GLOBAL"  to  the 
input  (DCL)  command  line.  If  the  match  is  successful,  then  the  parser 
queues  the  MAP  number  "PI"  (the  "P"  indicates  a  primary  mapping 
number)  to  the  I FORM  queue.  When  the  translator  reaches  LAUQ:,  it 
searches  the  IFORM  queue  for  the  MAP  number  "PI".  If  the  translator 
finds  the  MAP  number  "PI",  it  outputs  to  the  (forming)  MCR  command 
line  the  literal  "/GBL".  If  the  translator  cannot  find  the  MAP  number 
in  the  IFORM  queue,  it  does  not  use  the  syntax  element  (associated 
with  the  MAP  number)  in  the  translation. 

The  MAP  attribute  in  a  PT  can  associate  either  a  primary  or  a 
secondary  mapping  number  with  a  syntax  element,  but  not  both. 
However,  the  MAP  attribute  in  a  TT  can  associate  either  or  both 
mapping  numbers  with  a  syntax  element . 

Associating  a  primary  mapping  number  with  a  syntax  element  in  the  PT 
(by  means  of  the  MAP  attribute)  instructs  the  parser  to  queue  the 
primary  mapping  number  to  the  IFORM  queue.  Associating  a  secondary 
mapping  number  with  a  syntax  element  in  the  PT  instructs  the  parser  to 
queue  the  secondary  mapping  number  to  the  IFORM  queue.  In  both  cases 
the  parser  queues  a  mapping  number  only  if  the  parser  processes  the 
associated  syntax  element  successfully. 

The  MAP  attribute  in  a  TT  instructs  the  translator  to  search  the  IFORM 
queue  for  a  mapping  number.  When  found,  the  translator  marks  the 
mapping  number  used  and  processes  the  associated  syntax  element. 
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The  search  for  a  primary  mapping  number  differs  from  the  search  for 
secondary  mapping  numbers.  The  translator  searches  the  entire  I FORM 

translator  “  ,fi"d  ^i-ary  mapping 

The  translator  stan-=  f/ear  secondary  capping  numbers,  however. 

and 

moping  nu*«  “  the  "eXt  9U,Ue  eldment  »  Primary 

Specifying  both  a  primary  and  a  secondary  mapping  number  in  the  TT 

•f5^DMeXamplei:  MAP==<1  •1> )  _  instructs  the  translator  to  search  the  entire 
IFORM  queue  for  the  specified  primary  mapping  number  such  that  the 
specified  secondary  mapping  number  follows  without  any  intervening 
primary  mapping  numbers.  The  secondary  mapping  number  qualifies  the 

primary  mapping  number.  The  primary  mapping  number  is  the  object  of 
tne  search . 


If  the  translator  finds  a  mapping  number  in  the  IFORM  queue,  the 
translator  processes  the  associated  syntax  element.  If  the  translator 
fails  to  find  the  mapping  number,  the  processing  of  the  associated 
element  fails.  When  the  translator  finds  a  mapping  number  and 
successfully  processes  the  associated  syntax  element,  the  translator 
marks  as  used  the  queue  element  containing  the  found  mapping  number. 
A  used  mapping  number  can  no  longer  be  found.  This  prevents  infinite 
loops  in  the  TT  without  requiring  the  specification  of  termination 
conditions . 


A  MAP  attribute  can  be  specified  in  both  the  PT  and  the  TT  without 
associating  it  with  a  syntax  element,  as  follows: 


<MAP=n> 


If  you  specify  this  attribute  as  an  argument  to  an  AND  or  OR  macro  in 
a  PT,  the  parser  assumes  a  null  syntax  element.  A  null  syntax  element 
always  succeeds. 

If  you  specify  a  null  syntax  element  in  a  TT,  the  translator  (after 
finding  the  queue  element  containing  the  mapping  number)  checks  to  see 
if  a  character  buffer  is  attached  to  the  queue  element.  If  a 
character  buffer  is  attached,  then  the  translator  copies  the  contents 
of  the  buffer  to  the  MCR  command  line  buffer.  If  a  character  buffer 
is  not  attached,  then  the  translator  (like  the  parser)  assumes  a  null 
syntax  element  (which  always  succeeds). 

The  parser  attaches  the  character  buffer  to  the  queue  element.  The 
COP  attribute  instructs  the  parser  to  create  the  character  buffer  and 
copy  the  text  parsed  by  the  associated  syntax  element  to  the  character 
buffer  (See  Section  12.10  for  details  on  the  COP  attribute). 

Thus,  mapping  starts  in  the  parser  process  when  the  parser  queues 
mapping  numbers  to  the  IFORM  queue,  as  it  successfully  processes 
syntax  elements  that  have  associated  MAP  attributes. 

Mapping  is  completed  in  the  translator  process  when  the  translator 
detects  mapping  numbers  in  the  IFORM  queue  and  translates  the  syntax 
elements .  Note  that  the  translator  does  not  output  a  syntax  element 
that  has  a  MAP  attribute  associated  with  it  unless  (1)  the  translator 
first  finds  the  mapping  number  in  the  /FORM  queue,  and  (2)  the  mappinq 
number  has  not  been  previously  used. 
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Here  is  an  example  of  a  complete  command  table  (with  DCL-MCR  mapping) 
for  the  DCL  ASSIGN  command: 


ASSIGN::  AND 
END 

QUAL:  AND 

END 

QUALI :  OR 

OR. 
OR. 
OR. 
END 

TERM:  AND 

END 


ASSIGN  MML  NOTATION  FOR  PARSER  TABLE 

'ASSIGN  <QUAL  OPTR=T>  <$DEV  MAP=1>  <$DEV  MAP=2> 

'/  QUALI 

< ' LOCAL , 3  > 

<’ LOGIN, 3  MAP=3> 

< ' GLOBAL , 2  MAP=4 > 

TERM 

< 'TERMINAL, 4> '  <DEV  MAP=5> 


ASN  MML  NOTATION  FOR  TRANSLATOR  TABLE 


ASN : :  AND 

END 

LAUQ :  OR 

OR. 
OR. 
END 

MRET :  AND 

END 


'ASN  <MAP=1 >  '=  <MAP=2>  <LAUQ  OPTR=T> 

<' /LOGIN  MAP=3  > 

< ' /GBL  MAP=4> 

MRET 

'/TERM=  <MAP=5> 


For  a  complete  description  of  the  MAP  attribute,  see  Section  12.10. 
For  information  on  related  attributes  see  the  discussions  of  the 
following: 


DMAP ,  NO,  COP,  OCOP,  TST ,  and  DIR 

The  parser  records  mapping  information;  the  translator  detects  the 
mapping  information.  The  following  section  presents  I FORM,  the 
dynamic  data  structure  that  passes  mapping  information  from  the  parser 
to  the  translator. 


12.9  THE  INTERMEDIATE  FORM  ( IFORM) 

The  IFORM  contains  the  essential  information  (extracted  from  the  input 
DCL  command  line)  that  the  translator  needs  to  construct  the  MCR 
command  line.  The  IFORM  consists  of  three  data  structures:  the 
queue,  the  character  buffers,  and  the  general  bit-mask  words. 

NOTE 

To  display  the  IFORM  for  a  given  DCL  command,  use  SET 
DEBUG/FULL. 

The  parser  creates  the  IFORM  queue  when  it  successfully  processes 
syntax  elements  with  MAP  attributes.  Each  time  the  parser 
successfully  processes  a  MAP  attribute,  it  queues  the  mapping  number 
to  the  IFORM  queue. 

The  parser  creates  a  character  buffer  when  a  syntax  element  has  both 
MAP  and  COP  attributes .  The  parser  attaches  the  character  buffer  to 
the  queue  entry  that  contains  the  mapping  number .  The  character 
buffer  contains  the  text  parsed  during  the  processing  of  the 
associated  syntax  element. 
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A  syntax  element  with  a  COP  attribute  and  no  MAP  attribute  instructs 
the  parser  to  copy  the  text  parsed  to  the  last  queued  mapping  number 
(creating  and  attaching  the  character  buffer  if  neccessarjo . 

The  general  bit-mask  words  are  two  words  used  as  a  set  of  32  flags 
Mwf  Pars?er/translator  process  attaches  no  meaning  to  the  flags,  but 
MML  provides  a  set  of  attributes  to  set  flags,  clear  them,  test  if  the 
flags  are  set,  and  test  if  the  flags  are  clla^.  You  can  use  Xe  fl£™ 
to  check  for  contradictory  syntax.  In  addition,  use  the  flags  to  pass 
information  from  the  parser  to  the  translator.  For  example,  set  a 
flag  during  the  parser  process  if  a  DCL  qualifier  is  seen  and  detect 
MCR  switch  9  Uring  the  translator  process,  generating  the  equivalent 

JS!nSa?Slat°^S;ar6hfS  the  IF0RM  queue  for  maPPing  numbers.  If  the 
translator  finds  the  mapping  numbers,  it  processes  the  syntax 

?,u“Sl*t0r  Mnn0t  fina  the  n,appin9  the" 

as  follows^tribUte  iS  specified  -thout  an  associated  syntax  element 
<MAP=n> 

tlle  translatoi'  first  finds  the  queue  element  containing  the  mappinq 
number  and  then  examines  the  queue  element  for  a  character  buffer 

a!!aC!?ef  b K  mSanS  °f  the  COP  attribute.  If  the  translator  finds  an 
attached  character  buffer,  it  copies  the  contents  of  the  buffer  to  the 
MCR  command  line  buffer .  If  the  translator  cannot  find  an  attached 
buffer,  it  assumes  a  null  syntax  element  (which  always  succeeds). 

Use  the  following  attributes  (in  the  PT)  to  direct  the  parser  in  the 
creation  of  the  IFORM: 


MAP=n 

MAP=< , n> 

(map) 

DMAP=n 

DMAP=< , n> 

(map  unless  duplicate  exists) 

COP=T 

OCOP=T 

(copy,  or  copy  optional  input) 

BS=n 

BS=</n>  BS=<n,n> 

(set  bit  in  mask  word) 

BC=n 

BC=< , n>  BC=<n,n> 

(clear  bit  in  mask  word) 

NO=T 

(repeats  for  negative  form  of 

syntax  element) 

the  following  attributes  (in 
examination  of  the  IFORM: 

the  TT)  to  direct  the  translator  in 

MAP=n 

MAP=  < , n>  MAP=<n,n> 

( unmap) 

BST=n 

BST=< , n>  BST=<n,n> 

(test  for  bit  set  in  mask  word) 

BCT=n 

BCT=< , n>  BCT=<n,n> 

(test  for  bit  clear  in  mask  word) 

TST=T 

(test  for  mapping  number,  do  not 
mark  as  used) 

DIR=T 

(search  IFORM  in  reverse  direction) 

details 

on  these  attributes. 

see  Section  12.10. 
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For  example,  if  the  input  command  line  is: 

ASSIGN  DK1 :  SY s 

then  the  IFORM  would  be: 

Queue  Character  Buffer 


PI 

DKl : 

P2 

SY: 

If  the  input  command  line  is: 

ASSIGN/LOGIN/T : TT12 :  DK1 :  SY: 
then  the  IFORM  would  be: 

Queue  Character  Buffer 


P3 

P5 

TT12  : 

PI 

TW1  « 

JJi\  ±  • 

P2 

SY: 

12.10  ATTRIBUTES  OF  SYNTAX  ELEMENTS 


Attributes  associate  characteristics  with  literal  and  nonliteral 
syntax  elements.  The  parser/translator  processes  attributes  either 
before  or  after  it  processes  the  associated  syntax  elements  (depending 
on  the  attribute) .  The  processing  of  attributes  can  influence  the 
processing  of  the  associated  syntax  elements. 

Here  is  the  format  for  specifying  attributes  as  part  of  an  argument  to 
an  AND  or  OR  macro: 


< ' literal  KEY=value  KEYl=value  . . . > 
or 


< label 


KEY=value  KEYl=value  . . . > 


where : 

literal 

label 

KEY 


Literal  (ASCII)  string 

Nonliteral  (address  of  an  AND  or  OR  macro) 
Attribute  keyword  identifying  the  attribute 


value  Value  assigned  to  the  attribute 

Note  the  use  of  the  angle  brackets  "<"  and  " >"•  Use  these  MACRO-11 
symbols  to  indicate  that  everything  enclosed  is  considered  as  one 
argument  (when  expanding  macros).  Do  not  confuse  these  MACRO-11  angle 
brackets  with  the  angle  brackets  used  to  indicate  nonliterals  in 
metalanguage  notation. 
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12.10.1  AND 

AND  allows  you  to  extend  a  syntax  element  by  specifying  a  nonliteral 

that  is  ANDed  to  the  syntax  element.  The  primary  function  of  AND  is 

??  t0  mixed  With  AND  lo9ic  •  Assign  a  nonliteral  to 

the  AND  attribute  as  follows: 

AND= label 


where : 

label  Nonliteral  address  of  an  AND  or  OR  macro 

AND  instructs  the  parser/translator  to  process  the  AND  or  OR  macro 
that  the  label  (the  nonliteral)  addresses  in  addition  to  processinq 
the  syntax  element  with  which  the  AND  attribute  is  associated. 

For  example,  in  the  following  MML  definition  for  QUAL,  the  second 
syntax  element  defines  the  structure  "FILE : <filespec> " : 

QUAL: 


OR 

'BRIEF 

OR. 

< 1  FILE  AND=FNAME> 

OR. 

'FULL 

END 

AND 

' :  $FILE 

END 

There  are  three  syntax  elements  in  this  structure: 
FILE 
and 


and 

<  f ilespec> 

The  literal  " : "  and  the  nonliteral  <filespec>  connect  to  the  literal 
FILE'  by  means  of  the  AND  attribute.  The  parser/translator  processes 
all  three  elements  as  one  element  to  the  OR  macro  by  definition  of  the 
AND  attribute. 


12.10.2  BC  and  BS 

BC  (Bit  Clear)  and  BS  (Bit  Set)  operate  on  two  global  bit— mask  words 
as  follows: 

•  The  BC  attribute  instructs  the  parser/translator  to  clear  bits 
in  these  two  global  words. 

•  The  BS  attribute  instructs  the  parser/translator  to  set  bits 
in  these  two  global  words. 

Use  the  BCT  and  BST  attributes  to  test  these  bits.  (See  the  next 
section . ) 

The  format  for  these  attributes  is  as  follows: 

BC=n  or  BC=<,nl>  or  BC=<n,nl> 

BS=n  or  BS=<,nl>  or  BS=<n,nl> 
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where : 

n  Bit  mask  specifying  bits  in  the  first  global  word 

nl  Bit  mask  specifying  bits  in  the  second  global  word 

Specify  a  bit  mask  by  ORing  single  bit  specifications  with  the 
MACRO-11  symbol  "1".  The  symbols  Bl,  B2,...B32  are  predefined  to 
correspond  to  single  bit  specifications  for  each  bit  in  the  two  global 
words . 

For  example,  BS=BliB2!B5  means  to  set  bits  1,  2,  and  5  of  the  first 
global  word.  See  the  next  section  for  an  example  of  these  attributes 
in  use. 


12.10.3  BCT  and  BST 

BCT  (Bit  Clear  Test)  and  BST  (Bit  Set  Test)  test  the  status  of  bits  in 
the  two  global  bit-mask  words  as  follows: 

•  The  BCT  attribute  instructs  the  parser/translator  to  test 

whether  bits  are  cleared. 

•  The  BST  attribute  instructs  the  parser/translator  to  test 

whether  bits  are  set. 

See  the  previous  section  for  information  on  how  these  bits  are  set  or 
cleared.  The  parser/translator  does  not  clear  the  two  global  bit-mask 
words  between  the  parse  and  the  translation.  You  can  use  these  words 
as  part  of  the  I FORM  to  pass  information  from  a  PT  to  a  TT. 

The  format  for  these  attributes  is  as  follows: 

BCT=n  or  BCT=<,nl>  or  BCT=<n,nl> 

BST=n  or  BST=<,nl>  or  BST=<n,nl> 

where : 

n  Bit  mask  specifying  bits  in  the  first  global  word 

nl  Bit  mask  specifying  bits  in  the  second  global  word 

For  example,  BST=< , B19 I B31 >  means  to  test  whether  bits  19  and  31  of 
the  second  global  bit-mask  word  are  set. 

The  following  example  illustrates  the  use  of  BS,  BC,  BST,  and  BCT: 


COPY: 

AND 

FILE  <FILE  0PTR= 

=T>  QUA= 

II 

o 

G 

END 

FILE: 

OR 

<$NFIL 

BS=B1 

BCT=B2 !B3> 

OR. 

$FILE 

END 

QUAL: 

OR 

< ' INDEX 

BS=B2 

BCT=B1 1B3> 

OR. 

< ’SEQUENTIAL 

BS=B3 

BCT=B1 1 B2  > 

END 

In  this  example,  INDEX  and  SEQUENTIAL  are  qualifiers,  $NFIL  is  a 
predefined  syntax  element  that  is  a  file  specification  that  has  a  node 
name  prefixing  it,  and  $FILE  is  a  predefined  syntax  element  that  is  a 
conventional  file  specification  (without  a  node  name) .  The  example 
specifies  that  the  qualifiers  INDEX  and  SEQUENTIAL  are  contradictory. 
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that  INDEX  and  $NFIL  are  contradictory,  that  SEQUENTIAL  and  SNFIL  are 
contradictory,  but  that  duplicates  of  each  are  not  contradictory.  The 
BS  attribute  instructs  the  parser  to  set  the  specified  bits  if  the 
processing  of  the  associated  syntax  elements  is  successful.  The  BCT 
instructs  the  parser  to  test  whether  the  specified  bits  are  clear. 

If  the  tested  bits  are  set,  the  parser  does  not  process  the  associated 
syntax  elements.  Thus,  bits  are  set  to  remember  which  syntax  elements 
process  successfully,  and  bits  are  tested  to  determine  if  a 
contradiction  would  result  from  the  processing  of  syntax  elements. 

rnt,  m?in  di^e^en?e  between  the  BC,  BCT,  BS,  and  BST  attributes  and 
CBM  (described  in  the  next  section)  is  that  CBM  always  prevents 
duplicate  syntax  as  well  as  contradictory  syntax,  but  CBM  cannot  pass 
information  from  the  parser  to  the  translator. 


12.10.4  CBM,  CCBM 

Use  CBM  (Contradictory  Bit  Mask)  to  prevent  the  parser  or  translator 
from  allowing  contradictory  syntax.  To  indicate  that  two  or  more 
syntax  elements  cannot  be  specified  in  the  same  command  line,  specify 
CBM  with  each  syntax  element.  Assign  a  bit  mask  as  the  value  to  CBM. 
Specify  the  same  bit  in  each  bit  mask  associated  with  each 
contradictory  syntax  element. 

CBM  conditionalizes  the  processing  of  the  associated  syntax  element. 
The  parser  uses  the  specified  bit  mask  to  set  bits  in  two  global 
words.  If  the  parser  detects  that  any  bits  specified  in  the  bit  mask 
are  already  set  in  the  two  global  words,  then  the  parser  assumes  a 
contradiction  and  the  syntax  element  fails.  This  also  means  CBM  does 
not  allow  duplicate  syntax  elements . 

Also  note  that  the  parser/translator  clears  the  two  global  words 
between  the  parse  and  the  translation.  You  cannot  use  CBM  to  pass 
information  from  a  PT  to  a  TT. 


The  format  of  the  CBM  attribute  is  as  follows: 


CBM=n  or  CBM=<,nl>  or  CBM=<n,nl> 
where: 


n  Bit  mask  specifying  bits  in  the  first  global  word 

nl  Bit  mask  specifying  bits  in  the  second  global  word 

Specify  a  bit  mask  by  ORing  single  bit  specifications  with  the 
MACRO-11  symbol  "1".  The  symbols  B1 ,  B2,...,  B32  are  predefined  to 
correspond  to  single  bit  specification.  For  example,  CBM=B1!B2!B5 
specifies  bits  1,  2,  and  5  of  the  first  global  word,  and 
CBM=  < , B1 9 1 B3 1 >  specifies  bits  19  and  31  of  the  second  global  word. 

The  following  example  illustrates  the  use  of  the  CBM  attribute: 

QUAL :  OR  < ' LOCAL  CBM=B1 1 B2  > 

OR.  <’ LOGIN  CBM=B2  > 

OR.  <’ GLOBAL  CBM=B1> 

END 


The  example  specifies  that  the  literals  "LOCAL"  and  "GLOBAL"  are 
contradictory,  and  that  the  literals  "LOCAL"  and  "LOGIN"  are  also 
contradictory,  but  that  the  literals  "LOGIN"  and  "GLOBAL"  are  not. 
The  example  also  specifies  that  each  of  these  elements  can  be  used 
only  once . 
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CCBM  (Clear  Contradictory  Bit  Mask)  clears 
words.  The  format  for  specifying  CCBM  is 
you  use  to  specify  the  CBM  attribute. 


the  bits  in  the  two  global 
identical  to  the  format  that 


12.10.5  COP,  OCOP 

COP  (COPy)  is  legal  only  in  a  PT  and  only  with  a  literal  syntax 
element.  COP  passes  a  literal  from  the  input  DCL  command  line  to  the 
I FORM .  The  translator  can  then  use  the  literal  in  the  MCR  command 
line.  The  parser  copies  the  literal  to  a  character  buffer  an 
attaches  it  to  the  mapping  number  last  queued.  If  you  specify  a  MAP 
attribute  with  the  COP  attribute,  the  mapping  number  (assigned  to  the 
MAP  attribute)  is  the  mapping  number  last  queued.  The  format  of  the 
COP  attribute  is  as  follows: 


C0P=T 

For  example,  the  following  code  defines  a  terminal  specification: 

TERM:  OR  < ' TT  C0P=T  AND=N> 

OR.  < ' HT  C0P=T  AND=N > 

OR.  <‘VT  C0P=T  AND=N> 

OR.  < ' TI  C0P=T  AND=N> 

END 

N:  AND  <$0NUM, 0 , 3 >  <':  0C0P=T> 

This  code  parses  and  copies  a  terminal  name  as  TT ,  VT,  HT,  or  TI 
followed  by  an  octal  number  as  terminal  names.  (See  Section  12.11.1 
for  a  description  of  $0NUM,  which  defines  an  octal  number.)  The  OCOP 
attribute  assures  the  presence  of  the  terminating  colon  by  copying  it 
into  a  character  buffer  whether  or  not  the  user  inputs  one. 

To  instruct  the  translator  to  copy  the  character  buffer  to  the  MCR 
command  line,  specify  the  MAP  attribute  as  follows,  without  specifying 
an  associated  syntax  element: 

<MAP=n> 

When  the  translator  processes  a  MAP  attribute  that  has  no  associated 
syntax  element,  the  translator  examines  the  mapping  number  queue 
element  for  an  attached  character  buffer .  If  a  character  buffer  is 
found,  the  translator  copies  the  contents  of  the  character  buffer  to 
the  forming  MCR  command  line  buffer.  If  a  character  buffer  is  not 
found,  the  translator  assumes  a  null  syntax  element  (which  always 
processes  successfully) . 

OCOP  (Optional  COPy)  is  identical  to  COP  except  for  one  significant 
difference.  OCOP  instructs  the  parser  to  copy  the  literal  to  the 
I FORM  whether  or  not  the  processing  of  the  literal  succeeds.  That  is, 
the  literal  is  optional  and  always  succeeds  if  you  associate  OCOP  with 

it . 

The  following  illustrates  the  use  of  the  OCOP  attribute: 

DEV:  AND  <$ALF,2,2>  <$NUM,0,3>  <':  0C0P=T> 

The  MML  definition  defines  a  device  specification  such  that  the  colon 
on  the  end  of  the  specification  is  optional.  The  translator  copies 
the  colon  to  the  output  MCR  command  line  whether  or  not  the  parser 
found  a  colon  in  the  input  DCL  command  line. 
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12.10.6  DIR 

DIR  (DIRection)  is  legal  only  in  the  TT  and  only  when  you  specify  it 

3  *  attribute*.  ,DIR  instructs  the  translator  to  search  the 

I FORM  queue  for  the  specified  mapping  number  in  reverse  order.  The 
normal  direction  of  the  search  is  from  the  head  of  the  queue  to  the 
tail  of  the  queue.  DIR  instructs  the  translator  to  search  the  I FORM 
queue  from  the  tail  to  the  head  of  the  I FORM  queue.  The  format  for 
DIR  is  as  follows: 


DIR=R 


The  following  example  of  a  TT  fragment  illustrates  the  use  of  the  DIR 
attribute : 


FILE:  AND 

END 

MORE :  AND 

END 


<MAP=1  DIR=R  <MORE  0PT=T> 


<<',>>  FILE 


This  example  defines  (recursively)  the  structure  of  a  file 
specification  list,  where  the  file  specifications  are  mapped  to 
mapping  number  1.  Due  to  the  associated  DIR  attribute,  the  translator 
searches  for  the  mapping  numbers  in  reverse  order;  thus,  the  list  of 
file  specifications  is  output  to  the  MCR  command  line  in  reverse 
order . 


NOTE 

The  double  angle  brackets  are  necessary  in  cases  where 
the  contents  of  the  brackets  include  a  MACRO-11 
separator  character  (in  this  case,  the  comma)  that  is 
to  be  treated  as  a  literal  by  MML . 


12.10.7  ERR 

ERR  (ERRor)  allows  you  to  associate  error  messages  with  syntax 
elements.  If  the  parser  or  the  translator  fails  to  process  a  syntax 
element,  and  the  syntax  element  has  ERR  specified,  then  the  parser  or 
translator  prints  the  error  message  specified  and  aborts  the  parse  or 
translation.  The  format  for  ERR  is  as  follows: 

ERR= ' string 

or 

ERR=label 

label:  ERROR  </string/> 

For  example,  to  specify  an  error  message  for  the  device  being 
assigned,  use  the  following  MML  notation  in  the  PT  for  the  ASSIGN 
command : 

AND  'ASSIGN  <QUAL  OPT=T>  <$DEV  ERR=< ' Invalid  device>> 
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Xf  the  parser  cannot  parse  the  input  DCL  command  line  text  that 
corresponds  to  the  device  specification  ($DEV),  the  parser  prints  the 
message  "ASSIGN  —  Invalid  device",  and  aborts  the  parse. 


12.10.8  HLP 

Use  HLP  (HeLP)  in  a  PT  only  to  associate  help  text  with  syntax 
elements  that  have  the  PRO  attribute  (Section  12.10.12)  specified. 
When  the  parser  is  prompting  and  a  "?"  character  is  input,  the  parser 
spawns  a  HELP  command.  The  parser  appends  the  text  specified  in  the 
HLP  attribute  to  the  HELP  command  "HELP  command"  where  "command"  is 
the  name  of  the  DCL  command  being  processed.  The  format  of  the  HLP 
attribute  is  as  follows: 

HLP= ' string 

or 

HLP=label 

label:  HELP  </string/> 

where : 

string  Appended  to  the  HELP  command 
label  Label  of  a  HELP  macro 

The  parser  appends  the  string  to  the  command  "HELP  command" ,  where 
"command"  is  the  name  of  the  current  command  being  processed.  For 
example,  if  you  specify  the  PT  for  ASSIGN  as: 

AND  <QUAL  OPTR=T>  <$DEV  PRO='Device?  HLP=< ' Logical  name>> 

and  the  user  types  a  "?"  in  response  to  the  prompt  "Device?",  the 
parser  forms  and  spawns  the  command  "HELP  ASSIGN  LOGICAL  NAME" . 

This  requires  a  file  named  DCLASSIGN . HLP  containing  the  necessary  help 
text.  For  the  format  of  the  HELP  file,  see  the  HELP  documentation  in 
the  RSX-11M  Command  Language  Manual,  the  RSX-11M-PLUS  Command  Language 
Manual  or  the  RSX-11M/M-PLUS  MCR  Operations  Manual. 


12.10.9  MAP,  DMAP 

MAP  is  legal  in  both  the  PT  and  the  TT.  However,  the  parser  and  the 
translator  interpret  MAP  differently.  The  following  summarizes  the 
types  of  legal  MAP  attributes  in  a  parser  table: 

MAP=n  Instructs  the  parser  to  queue  the  specified  primary 

mapping  number  n  to  the  IFORM  queue  only  if  the 
associated  syntax  element  is  successfully  parsed. 

MAP=< , nl >  Instructs  the  parser  to  queue  the  specified  secondary 

mapping  number  nl  to  the  IFORM  queue  only  if  the 
associated  syntax  element  is  sucessfully  parsed. 

Note  that  specifying  COP  with  MAP  in  a  PT  instructs  the  parser  to 
create  and  attach  a  character  buffer  to  the  mapping  number,  and  copy 
the  text  parsed  by  the  associated  syntax  element  to  the  attached 
character  buffer.  For  additional  details,  see  Section  12.10.5,  which 
describes  COP. 
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««f!«IritLrr'ar“eS  the  tyP6S  °£  16901  MAP  in  * 


MAP=n 


MAP=< , nl > 


MAP=<n ,  nl > 


Instructs  the  translator  to  search  the  I FORM  queue 
from  top  to  bottom  for  the  specified  primary  mapping 
number  n.  If  found,  the  translator  places  the  element 
in  the  MCR  command  line.  if  not  found,  nothing 
happens . 

Instructs  the  translator  to  search  the  IFORM  queue  for 
the  secondary  mapping  number  nl .  Because  the  object 
of  the  search  is  a  secondary  (not  primary)  mapping 
number,  the  translator  does  not  search  the  entire 
IFORM  queue.  The  translator  starts  searching  at  the 
last  used  primary  mapping  number  and  stops  the  search 
at  the  next  primary  mapping  number.  If  the  secondary 
mapping  number  is  found,  then  the  associated  syntax 
element  is  processed;  otherwise,  nothing  happens. 

Instructs  the  translator  to  search  the  IFORM  queue 
from  head  to  tail  for  the  specified  primary  mapping 
number  n.  If  found,  the  translator  searches  for  the 
specified  secondary  mapping  number  nl .  If  found,  the 
associated  syntax  element  is  processed.  If  not  found, 
another  occurrence  of  primary  mapping  number  n  is 
sought.  If  another  instance  of  primary  mapping  number 
n  is  found,  then  the  translator  looks  again  for  the 
specified  secondary  number  nl .  This  search  process 
continues  until  either  all  primary  mapping  numbers  n 
have  been  found  and  none  of  them  have  a  secondary 
maPPin9  number  nl  after  them,  or  until  a  primary 
mapping  number  n  is  found  that  does  have  a  secondary 
mapping  number  nl  after  it . 


If  you  specify  a  MAP  attribute  in  a  TT  without  specifying  an 
associated  syntax  element,  the  translator  examines  the  queue  element 
containing  the  specified  mapping  number  for  an  attached  character 
buffer.  If  the  translator  finds  an  attached  character  buffer,  the 
translator  copies  the  contents  of  the  buffer  to  the  forming  MCR 
command  line  buffer .  If  the  translator  does  not  find  an  attached 
character  buffer,  the  translator  assumes  a  null  syntax  element  (which 
always  processes  successfully) . 


allow  additional  flexibility  in  the  search  for  secondary  mapping 
numbers,  the  translator  supports  the  following  additional  formats  for 
specifying  the  MAP  attribute  in  a  TT: 


MAP=  <X , nl > 


MAP=<X1 , nl > 


Instructs  the  translator  to  search  the  IFORM  queue 
from  head  to  tail  for  the  specified  secondary  mapping 
number  nl .  If  found,  the  translator  processes  the 
associated  syntax  element.  If  not  found,  the 
associated  syntax  element  fails  to  process.  The 
keyword  "X"  identifies  this  MAP  attribute  as  an 
unconditional  search  for  a  secondary  mapping  number. 

Instructs  the  translator  to  seach  the  IFORM  queue  for 
the  secondary  mapping  number  nl .  The  keyword  "XI " 
instructs  the  translator  to  limit  the  search  of  the 
queue  as  follows.  The  search  is  started  at  the  head 
of  the  queue  and  proceeds  until  the  first  primary 
mapping  number  is  detected.  If  the  secondary  mapping 
number  nl  is  not  found,  then  another  search  is 
conducted.  The  second  search  looks  for  the  secondary 
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mapping  number  nl  such  that  it  follows  a  negative 
primary  mapping  number.  If  found,  the  translator 
processes  the  associated  syntax  element.  If  not 
found,  nothing  happens. 


Note  that  you  use  the  "X"  MAP  attribute  to  search  for  a  secondary  like 
a  primary  (that  is,  unconditionally)  and  the  "XI"  MAP  attribute  to 
search  for  floating  command  qualifiers.  For  information  on  floating 
command  qualifiers  see  Section  12.10.13,  which  describes  QUA. 


When  the  translator  finds  a  mapping  number  and  processes  the 
associated  syntax  element,  the  translator  marks  the  mapping  number  as 
used.  A  used  mapping  number  cannot  be  found  again  by  the  translator. 
Thus  marking  mapping  numbers  used  prevents  infinite  loops  in  the  TT 
without  the  need  to  specify  termination  conditions.  To  override  the 
marking  of  mapping  numbers,  use  TST.  To  reset  all  marked  mapping 
numbers,  use  the  $ RESET  predefined  syntax  element.  (This  is  useful 
for  generating  multiple  MCR  commands  by  means  of  the  $NEW  predefined 
syntax  element . ) 


DMAP  (duplicate  map)  is  identical  to  MAP  in  most  ways.  However,  it  is 
only  allowed  in  a  PT.  DMAP  instructs  the  parser  not  to  queue  the 
mapping  number  to  the  IFORM  queue  if  the  same  mapping  number  is 
already  present  in  the  IFORM  queue.  If  the  parser  does  not  queue  the 
mapping  number,  then  the  syntax  element  that  MAP  is  associated  with 
fails  to  process.  Thus,  the  DMAP  attribute  can  prevent  duplicate 
syntax . 


For  additional  information  on  the  use  of  the  MAP  attribute,  see  the 
Section  12.8,  Mapping  DCL  to  MCR. 


The  following  example  shows  the  use  of  primary  mapping  numbers  with 
predefined  syntax  elements. 

DCL  file  specifications,  device  specifications,  numerals,  and  so 
forth,  map  to  themselves.  That  is,  when  a  file  specification,  device 
specification,  numeral,  and  so  forth,  is  input,  the  same  file 
specification,  device  specification,  numeral,  and  so  forth,  is  output. 
Here  is  an  example  of  how  a  terminal  device  specification  maps  to 
itself . 


Parser  Table 


TERM:  AND  'TERMINAL:  <$DEV,MAP=2> 

END 


Translator  Table 

MRET :  AND  ' TERM=  <MAP=2> 

END 


The  parser  table  specifies  at  label  TERM:  If  the  input  command  line 
matches  a  device  specification  ($DEV),  then  queue  mapping  number  P2  to 
the  IFORM  queue,  attach  a  character  buffer  to  this  queue  element,  and 
copy  the  device  specification  to  the  attached  character  buffer.  The 
translator  table  specifies  at  label  MRET:  If  P2  is  in  the  IFORM 
queue,  then  output  the  contents  of  any  attached  buffer  to  the  forming 
MCR  command  line. 

The  following  example  illustrates  the  use  of  secondary  mappings. 
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When  translating  the  DCL  MACRO  command  to  the  MCR  MAC  command,  it  is 
necessary  to  determine  which  (if  any)  input  file  specification  has  the 
qualifier  /LIST  on  it.  That  is,  the  translator  must  be  able  to 
determine  (by  means  of  information  in  the  TT)  that  the  file 
specification  "C"  in  the  DCL  command  line  "MACRO  A, B, C/LIST, D"  has  the 

vEi?Th«U?iifi/??«Sn  it1'-,The  IF0RM  must  ma?  the  DCL  file  specification 
that  has  the  /LIST  qualifier  on  it  to  the  right  position  in  the  MCR 
command  line. 

The  mapping  can  more  easily  be  understood  from  the  viewpoint  of  the 
translator.  The  translator  generates  the  MCR  MAC  command  from  left  to 
right.  When  the  translator  reaches  the  position  in  the  output  MCR 
command  line  where  the  list  file  must  be  placed,  the  translator  looks 
n  the  IFORM  queue  for  the  mapping  number  that  represents  the  file 
specification  with  the  /LIST  qualifier  on  it.  Since  the  file 
specification  and  qualifier  are  two  distinct  syntax  elements,  there 
are  two  mapping  numbers  in  the  IFORM  queue  to  represent  them.  Also, 
since  the  IFORM  queue  is  a  linear  data  stucture  (and  not  a  tree)  ,  a 

means  of  associating  the  /LIST  qualifier  with  the  file  specification 
is  needed. 


To  express  an  association  between  elements  in  the  IFORM  queue,  use 
primary  and  secondary  mapping  numbers.  Secondary  mapping  numbers 
(such  as  SI)  have  meaning  only  as  related  to  primary  mapping  numbers 
(such  as  PI)  . 

The  following  MML  notation  expresses  this  mapping  and  illustrates  the 
use  of  primary  and  secondary  mappings. 

Parser  Table 


AND 

END 

’MACRO 

FILES: 

AND 

END 

<$F ILE 

MORE : 

AND 

END 

A 

A 

V 

V 

FILES 

MAP=1>  <’/LIST  OPT=T 
FILES 


MAP=< , 1>>  <MORE  OPT=T> 


Translator  Table 


AND  ’MAC  <0B J  OPT=T>  <LST  OPT=T>  ’  =  SELIF 

END 

LST :  AND  <<’,>>  <MAP=<1 , 1>> 

END 

SELIF: 


It  is  possible  when  parsing  (due  to  the  recursive  definition  of  FILES) 
to  queue  to  the  IFORM  queue  identical  map  numbers  ("PI")  that 
represent  the  input  file  specifications.  The  only  means  of 
distinguishing  the  "PI"  map  numbers  is  by  their  lef t-to-r ight 
positioning.  For  the  translator  to  find  the  "PI"  map  number  that 
represents  the  file  specification  with  the  /LIST  on  it,  the  translator 
has  to  find  the  "PI"  map  number  that  is  followed  by  the  "SI"  map 
number  such  that  there  are  no  intervening  "Pn"  map  numbers.  In  MML, 
to  instruct  the  translator  to  perform  such  a  search,  use  the  argument 
"<MAP=<1, 1>>" ,  as  specified  at  label  LST. 

Remember  that  if  a  reference  is  made  to  a  secondary  map  number  without 
specifying  a  primary  map  number,  then  the  translator  looks  for  a 
secondary  map  number  that  is  associated  with  the  last  used  primary  map 
number . 
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12.10.10  NO 

NO  is  allowed  only  in  a  PT.  NO  instructs  the  parser  to  process  either 
a  literal  "NO"  or  a  literal  before  it  processes  the  associated 

literal.  The  NO  attribute  is  legal  only  when  associated  with  a 
literal  syntax  element.  The  format  for  the  NO  attribute  is  as 
follows  2 

NO=T 

If  you  specify  a  MAP  with  a  NO,  the  parser  queues  two  different 
mapping  numbers.  If  the  parser  does  not  process  either  the  "NO"  or 
the  the  parser  queues  the  mapping  number  assigned  to  MAP.  If  the 

parser  does  process  either  the  "NO"  or  the  the  parser  increments 

the  mapping  number  by  one  before  it  queues  the  mapping  number. 

The  following  illustrates  the  use  of  NO: 

OR  < 1  LIST  MAP=10.  NO=T> 

In  this  example,  the  parser  attempts  to  parse  either  NOLIST,  —LIST,  or 
LIST.  If  LIST  is  parsed,  the  parser  adds  the  mapping  number  10  to  the 
I FORM  queue.  If  either  NOLIST  or  -LIST  is  parsed,  the  parser  queues 
the  mapping  number  11. 


12.10.11  OPT,  OPTR 

Use  OPT  (OPTional)  to  indicate  that  a  syntax  element  is  not  required. 
You  can  use  OPT  in  both  the  PT  and  the  TT .  The  parser  and  the 
translator  interpret  OPT  identically.  The  format  for  OPT  is  as 

follows  2 

OPT=T 

For  example,  to  specify  that  qualifiers  (label  QUAL)  are  optional 
syntax  in  the  ASSIGN  command,  use  the  following  MML  notation: 

AND  'ASSIGN  <QUAL  OPT=T>  ... 

The  parser  goes  to  label  QUAL  and  processes  the  syntax  defined  at 

label  QUAL.  If  the  parser  cannot  process  a  syntax  element  in  an  AND 

macro,  the  failure  implies  the  failure  of  the  AND  macro.  The  OPT=T 

attribute  tells  the  parser  to  ignore  the  failure  and  continue 
processing  the  AND  macro  with  the  next  ( left-to— right )  argument  to  the 
AND  macro. 

Use  OPTR  (OPTional  Repeat)  in  the  same  way  to  indicate  that  a  syntax 
element  is  not  required.  In  addition,  use  OPTR  to  indicate  that  the 
syntax  element  can  be  used  repeatedly  in  the  parse/translation  until  a 
failure  results.  In  other  words,  the  presence  of  OPTR  indicates  that 
the  syntax  element  can  be  used  to  parse  or  translate  syntax  from  zero 
to  an  infinite  number  of  times.  The  format  for  OPTR  is  as  follows: 

0PTR=T 

For  example,  to  specify  that  qualifiers  (label  QUAL)  are  optional 
syntax  in  the  ASSIGN  command  and  that  the  qualifiers  can  be  used 
repeatedly  in  the  input  command  line,  use  the  following  MML  notation: 

AND  'ASSIGN  <QUAL  OPTR=T>  ... 

The  parser  goes  to  label  QUAL  and  processes  the  syntax  defined  there. 
If  a  syntax  element  in  an  AND  macro  fails,  the  failure  cannot  be  used 
in  the  parse,  implies  the  failure  of  the  AND  macro.  The  OPTR=T 
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attribute  tells  the  parser  to  ignore  failure  and  to  continue 
processing  the  AND  macro  with  the  next  ( left-to-right )  argument  to  the 
AND  macro.  However,  if  and  while  the  syntax  defined  at  label  QUAL 
matches  the  input  command,  the  parser  uses  it  repeatedly. 

If  the  OPT  and  AND  attributes  are  used  in  the  same  syntax  element,  the 
OPT  modifies  the  AND.  That  is,  the  OPT  does  not  modify  the  entire 
syntax  element. 

For  example,  here  is  a  fragment  of  code  based  on  the  LINK  command 
translator  table.  The  TT  specifies  a  TKB  switch  that  can  be  specified 
with  or  without  arguments  attached. 


OR.  <‘/PR  MAP=1  AND=PRI V  OPT=T> 

END 


PRIV :  AND  '  :  <MAP=3> 

END 

In  the  example,  the  optional  argument  to  the  /PR  switch  is  attached  to 
mapping  number  3.  The  OPT  applies  to  AND=PRIV  and  not  to  the  whole 
syntax  element.  If  the  OPT  applied  to  the  entire  syntax  element,  then 
the  entire  OR  macro,  of  which  this  fragment  is  a  part,  would  always 
succeed . 


12.10.12  PRO 

Use  PRO  (PROmpt)  in  the  PT  to  associate  prompt  strings  with  syntax 
elements.  If  the  parser  detects  end-of-line  while  processing  a  syntax 
element  that  has  the  PRO  attribute  specified,  the  parser  prints  the 
prompt  string  specified,  and  suspends  itself  to  wait  for  more  input. 
The  parser  appends  any  input  received  to  the  input  DCL  command  line. 
PRO  is  legal  only  in  the  PT .  The  translator  does  not  prompt.  The 
format  of  PRO  is  as  follows: 

PR0= ' string 

or 

PRO=label 

label:  PROMPT  </string/> 

where : 

string  ASCII  string  to  be  used  as  the  prompt  string 

label  (MACRO-11)  label  of  a  (MACRO-11)  PROMPT  macro 

Thus,  specify  the  prompt  string  directly  after  the  "="  symbol,  or  as 
the  argument  to  the  PROMPT  macro.  The  PROMPT  macro  allows  global 
prompt  strings,  which  conserve  space. 

The  following  example  illustrates  the  use  of  PRO: 

AND  <QUAL  0PTR=T>  <$DEV  PR0= ' Device? >  <$DEV  PR0=PR0DEV> 

PRODEV:  PROMPT  </Logical  device?  /> 
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The  command  requires  two  device  specifications  ($DEV).  If  the  parser 
expects  the  first  $DEV  but  reaches  the  end  of  the  line,  then  the 
parser  prompts  as  follows: 

Device? 

If  the  parser  expects  the  second  $DEV  but  reaches  the  end  of  the  line, 
then  the  parser  prompts  as  follows: 

Logical  device? 


12.10.13  QUA 

Use  QUA  (QUAlifier)  to  specify  qualifiers.  You  can  specify  floating 
or  positional  qualifiers.  Floating  qualifiers  are  qualifiers  that  are 
legal  anywhere  in  the  input  DCL  command  line.  Positional  qualifiers 
are  qualifiers  that  are  legal  only  at  specific  positions  in  the  input 
DCL  command  line  or  output  MCR  command  line . 

The  positional  form  of  the  QUA  attribute  is  legal  in  both  a  PT  and  a 
TT.  The  floating  form  is  legal  only  in  a  PT .  The  format  for  QUA  is 
as  follows: 


QUA=label 


where : 

label  Nonliteral  (address  of  an  AND  or  OR  macro) 

When  the  QUA  attribute  is  used  in  a  PT  and  the  parser  encounters  a 
slash  (/)  in  an  appropriate  location,  it  attempts  to  match  the  text 
following  the  slash  with  one  of  the  elements  of  the  AND  or  OR  macro  at 
the  specified  label.  If  an  end-of-line  is  encountered  after  the 
slash,  the  parser  issues  a  prompt.  If  an  illegal  qualifier  is  given, 
then  an  error  message  is  printed  and  the  parse  is  aborted.  The  list 
of  qualifiers  is  repeatedly  scanned  until  all  qualifiers  in  the  input 
command  line  have  been  parsed. 

To  specify  a  positional  QUA  attribute,  use  QUA  as  part  of  a  syntax 
element.  For  example: 

AND  <’ AS SIGN, 3  QUA=QUAL>  $DEV  $DEV 

END 


QUAL:  OR 

OR. 
OR. 
OR. 
END 


< 'GLOBAL, 1> 
< 'LOCAL, 3 > 

< 'LOGIN, 3 > 
TERM 


In  this  case,  any  qualifiers  (such  as  /GLOBAL)  must  immediately  follow 
"ASSIGN"  in  the  command  line.  (See  the  following  example  for  more 
details  on  how  the  QUA  attribute  works.) 

To  specify  floating  qualifiers,  use  QUA  as  a  separate  argument  to  an 
AND  macro,  not  as  part  of  another  argument.  The  parser  attempts  to 
match  the  qualifiers  defined  at  the  label  before  and  after  it 
processes  each  argument  of  the  AND  macro.  That  is,  the  qualifiers 
float  before  and  after  each  syntax  element  defined  by  the  AND  macro. 
Furthermore,  the  parser  attempts  to  parse  the  floating  qualifiers 
after  any  prompts.  If  QUA  is  being  used  to  specify  floating 
qualifiers,  it  must  be  an  argument  to  an  AND  macro,  rather  than  an 
AND.  (extension)  macro.  The  floating-qualifier  form  of  QUA  is  legal 
only  in  a  PT. 
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The  following  illustrates  the  floating-qualifier  form  of  QUA: 

AND  'ASSIGN ,  3  $DEV  $DEV  QUA=QUAL 

END 


QUAL :  OR 

OR. 
OR. 
OR. 
END 


< ' LOCAL , 3  > 

< 'LOGIN, 3 > 

< 'GLOBAL, 1> 
TERM 


The  label  QUAL  defines  the  allowable  qualifiers.  The  parser  checks 
for  the  qualifiers  before,  between,  and  after  the  $DEV  syntax 
elements.  Before  the  parser  transfers  parsing  control  to  the  OR  macro 
at  label  QUAL,  the  parser  attempts  to  parse  the  slash  "/"  character. 
Only  if  the  parser  successfully  parses  the  slash,  does  it  attempt  to 
parse  the  qualifiers  defined  at  label  QUAL.  If  the  parser  detects  the 
end  of  the  input  DCL  command  line  after  it  parses  a  slash  character, 
the  parser  prompts  for  more  input.  If  a  slash  is  detected  and  the 
qualifiers  defined  at  label  QUAL  fail  to  process,  the  parser  issues  an 
error  message  and  aborts  the  parse.  The  parser  repeatedly  attempts  to 
parse  the  qualifiers  until  it  no  longer  can  parse  a  slash  character. 


Thus,  using 
following : 

QUA 

in  the  previous  example 

is  equivalent  to  the 

AND 

END 

<QUAL  0PTR=T>  $DEV  <QUAL 

OPTR=T>  $DEV  <QUAL  OPTR=T> 

QUAL: 

AND 

'/  <QUAL1  PRO=' Qualifier? 

ERR=< ' Illegal  qualif ier> > 

QUAL1 : 

OR 

< 'LOCAL, 2> 

OR. 

< 'LOGIN, 2 > 

OR. 

< ' GLOBAL, 1> 

END 

The  following  illustrates  the  use  of  the  QUA  attribute  in  a  TT. 

ASN : :  AND  <<'ASN  >>  <MAP=1>  '=  <MAP=2  QUA=LAUQ > 

END 

LAUQ :  OR  < ' GBL  MAP=4  > 

OR.  < 'LOGIN  MAP=3> 

OR.  MRET 
END 

The  label  LAUQ  defines  the  MCR  switches  equivalent  to  the  DCL 
qualifiers.  The  translator  processes  QUA  just  as  does  the  parser. 
However,  instead  of  parsing  the  input  DCL  command  line  for  qualifiers, 
the  translator  uses  the  qualifiers  to  construct  the  equivalent  MCR 
command  line.  Remember  that  QUA  automatically  includes  slashes  before 
each  switch. 


12.10.14  TST 

TST  is  legal  only  in  a  TT  and  only  when  specified  with  MAP.  TST 
instructs  the  translator  not  to  mark  a  mapping  element  used  in  a 
translation  as  having  been  used.  The  format  of  the  TST  attribute  is 
as  follows: 

TST=T 
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The  following  illustrates  the  use  of  the  TST  attribute: 

MCRCOP :  OR  <PIP  MAP=1  TST=T> 

OR.  <PIP  MAP =2  TST=T> 

OR.  <NFT  MAP=3> 

END 

In  the  previous  example,  the  OR  macros  instruct  the  translator  to 
process  the  nonliteral  PIP  if  either  mapping  numbers  1  or  2  are  in  the 
IFORM  queue,  or  to  process  the  nonliteral  NFT  if  mapping  number  3  is 
in  the  IFORM  queue.  The  TST  attribute  associated  with  the  syntax 
element  PIP  instructs  the  translator  not  to  mark  mapping  numbers  2  or 
3  as  having  been  used.  This  allows  the  syntax  defined  at  label  PIP  to 
use  these  mapping  numbers  also. 


12.11  PREDEFINED  SYNTAX  ELEMENTS 

Predefined  syntax  elements  (PSEs)  are  syntax  elements  defined  for  use 
by  all  DCL  command  tables.  PSE  names,  by ^  convention,  are 
distinguished  from  local  category  names  by  having  a  $  as  their  first 
character . 

NOTE 

If  the  syntax  of  a  command  does  not  match  that  of  a 
predefined  syntax  element,  then  the  parse  fails. 

Several  PSEs  have  two  forms,  one  ending  with  an  "E" 
and  one  not,  such  as  $NOD  and  $NODE,  $FIL  and  $FILE, 

$DEV  and  $DEVE ,  and  $UIC  and  $UICE.  The  form  ending 
in  "E"  produces  an  error  message  before  aborting  the 
parse.  The  shorter  form  does  not.  Use  the  shorter 
form  when  defining  optional  syntax. 

The  following  list  briefly  defines  the  PSEs.  Note  that  some  PSEs 
require  arguments.  Specify  the  required  arguments  in  the  order  shown 
and  enclose  the  PSE  and  the  arguments  in  angle  brackets  to  identify 
the  PSE  and  arguments  as  one  argument  to  the  MACRO-11  assembler. 


12.11.1  Basic  Data  Types 

The  following  list  of  PSEs  define  basic  data  types  in  MML.  You  can 
use  them  only  in  a  PT .  The  parser  copies  to  an  IFORM  character  buffer 
the  text  in  the  input  DCL  command  line  that  fits  the  structure  defined 
by  the  PSE.  The  buffer  is  attached  to  the  last  queued  mapping  number 
and  can  be  accessed  by  the  translator  for  use  in  constructing  the 
equivalent  MCR  command  line. 

$NUM,A1,A2  Defines  the  structure  or  syntax  of  a  numeric  string 

(0  through  9).  The  arguments  A1  and  A2  designate  the 
minimum  and  maximum  length,  respectively,  for  the 
numeric  string.  Additionally,  the  PSE  allows  an 
optional  decimal  point  on  the  end  of  the  string.  The 
decimal  point  is  not  copied  to  the  IFORM  character 
buffer . 
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$DNUM,A1,A2 


$ONUM,Al,A2 


$ WONUM , A1 , A2 


$  DONUM , A1 , A2 [ . 


$WDONUM , A1 , A2 


$BNUM , A1 , A2 


$ ALF , A1 , A2 


$ALFN, A1 , A2 


$WALFN,A1,A2 


$R50,A1,A2 


Defines  the  structure  or  syntax  of  a  decimal  numeric 
string  (0  through  9).  The  arguments  A1  and  A2 
designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string.  Additionally, 
the  PSE  allows  an  optional  decimal  point  on  the  end 
of  the  string.  A  decimal  point  is  copied  to  the 
I FORM  character  buffer  whether  or  not  it  is  specified 
in  the  input  DCL  command  line. 

Defines  the  structure  or  syntax  of  an  octal  numeric 
string  (0  through  7).  The  arguments  A1  and  A2 
designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string. 

Defines  the  structure  or  syntax  of  $ONUM  or  the 
wildcard  character  The  arguments  A1  and  A2 
designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string. 

Defines  the  structure  or  syntax  of  a  decimal  or  octal 
numeric  string  (0  through  9).  The  arguments  A1  and 
A2  designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string.  Additionally, 
the  PSE  allows  an  optional  decimal  point  on  the  end 
of  the  string.  A  decimal  point  is  copied  to  the 
I FORM  character  buffer  if  either  the  input  DCL 
command  line  or  the  parsed  string  contains  the 
characters  8  or  9. 

Defines  the  structure  or  syntax  of  $D0NUM  or  a  "*" 
character .  The  arguments  A1  and  A2  designate  the 
minimum  and  maximum  length,  respectively,  for  the 
numeric  string. 

Defines  the  structure  or  syntax  of  a  binary  numeric 
string  (0  through  1).  The  arguments  A1  and  A2 
designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string. 

Defines  the  structure  or  syntax  of  an  alphabetic 
string  (A  through  Z)  .  The  arguments  A1  and  A2 
designate  the  minimum  and  maximum  length  for  the 
alphabetic  string. 

Defines  the  structure  or  syntax  of  an  alphanumeric 
string  (0  through  9  and/or  A  through  Z) .  The 
arguments  A1  and  A2  designate  the  minimum  and  maximum 
length  for  the  alphanumeric  string. 

Defines  the  structure  or  syntax  of  $ALFN  with  the 
additional  characters:  "*"  and  "%”.  These 
characters  are  used  by  some  RSX-11M/M-PLUS  utilities 
as  wildcard  characters.  The  arguments  A1  and  A2 
designate  the  minimum  and  maximum  length  for  the 
alphanumeric  string. 

Defines  the  structure  or  syntax  of  a  Radix-50  string 
(0  through  9,  A  through  Z,  "$",  and  The 
arguments  A1  and  A2  designate  the  minimum  and  maximum 
length  for  the  Radix-50  string. 
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12.11.2  Common  Command  Elements 


The  following  PSEs  define  parts  of  the  DCL  command  grammar.  You  can 
use  them  only  in  a  PT.  The  text  (except  for  $DATE )  parsed  from  the 
input  DCL  command  line  that  fits  the  structure  defined  by  the  PSE  is 
copied  to  an  IFORM  character  buffer  that  is  attached  to  the  last 
queued  mapping  number . 


$FIL 


Defines  the  structure  or  syntax  of  a  file 
specification.  Each  element  explicitly  included  in  the 
file  specification  sets  a  bit  in  the  global  bit-mask 
words.  These  are: 


device  B28  filetype  B31 

UIC  B29  version  B32 

filename  B30 


$FILE 

$WFIL 

$WFILE 

$NFIL 

$NFILE 

$  IFIL 

$ IFILE 

$NOD 

$NODE 

$DEV 

$DEVE 


These  bits  are  also  set  by  the  other  $FIL-based 
predefined  syntax  elements. 

Defines  the  structure  or  syntax  of  $FIL.  Additionally, 
if  the  parser  fails  to  process  $FILE ,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

Defines  the  structure  or  syntax  of  $FIL.  Additionally, 
the  wildcard  characters:  and  "%"  are  allowed  as 
part  of  the  file  specification. 

Defines  the  structure  or  syntax  of  $WFIL. 
Additionally,  if  tl 3  parser  fails  to  process  $WFILE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

Defines  the  structure  or  syntax  of  $WFIL  if  preceded  by 
a  DECnet  node  specification. 

Defines  the  structure  or  syntax  of  $NFIL . 
Additionally,  if  the  parser  fails  to  process  $NFILE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

Defines  the  structure  or  syntax  of  $FIL.  Additionally, 
the  indirect  file  indicator  must  prefix  the  file 
specification . 

Defines  the  structure  or  syntax  of  $IFIL. 
Additionally,  if  the  parser  fails  to  process  $IFILE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

Defines  the  structure  or  syntax  of  a  DECnet  node  name 
specification . 

Defines  the  structure  or  syntax  of  $NOD.  Additionally, 
if  the  parser  fails  to  process  $NODE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

Defines  the  structure  or  syntax  of  a  device 
specification . 

Defines  the  structure  or  syntax  of  $DEV.  Additionally, 
if  the  parser  fails  to  process  $DEVE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 
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$ODEV 

Defines  the  structure  or  syntax  of  $DEV.  Additionally, 
the  character  is  optional  syntax. 

$ODEVE 

Defines  the  structure  or  syntax  of  $ODEV. 

itionally,  if  the  parser  fails  to  process  ?ODEVE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$UIC 

Defines  the  structure  or  syntax  of  a  UFD  specification. 

$UICE 

Defines  the  structure  or  syntax  of  $UIC.  Additionally, 
if  the  parser  fails  to  process  $UICE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

$WUIC 

Defines  the  structure  or  syntax  of  $UIC.  Additionally, 
the  wildcard  character  is  allowed  as  part  of  the 
UIC  specification. 

$WUICE 

Defines  the  structure  or  syntax  of  $WUIC. 
Additionally,  if  the  parser  fails  to  process  $WUICE* 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$OUIC 

Defines  the  structure  or  syntax  of  $UIC.  Additionally, 
the  characters  and  " , "  are  optional  syntax. 

$OUICE 

Defines  the  structure  or  syntax  of  $OUIC. 
Additionally,  if  the  parser  fails  to  process  $OUICE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$DATE 

Defines  the  structure  or  syntax  of  a  date 
specification.  A  date  specification  can  take  one  of 
two  forms:  mm/dd/yy  or  dd-mmm-yy.  $DATE  produces  the 
following  data  structures  in  the  IFORM  queue:  the  day 
is  attached  to  secondary  mapping  number  210,  the  month 
is  attached  to  secondary  mapping  number  211,  and  the 
year  is  attached  to  secondary  mapping  number  212.  The 
output  format  is  always  dd-mmm-yy  (with  the  first  three 
characters  of  the  month  name  spelled  out)  even  if  the 
slash  format  (with  the  number  of  the  month)  is  used. 

$DATE1 

For  commands  that  require  two  dates  (for  example,  SINCE 
and  THROUGH),  a  second  PSE  for  dates,  $  DATE 1 ,  uses 
secondary  mapping  numbers  213,  214,  and  215  for  the 
day,  month,  and  year  respectively.  $DATE1  is  otherwise 
identical  to  $DATE . 

$TIME 

Defines  the  structure  or  syntax  of  a  time 
specification.  The  time  specification  is  of  the  form 
hh :mm[ : ss] . 

12.11.3  Special  Parser  Elements 

You  can  specify  the  following  PSEs  only  in  a  PT. 


$ALL,  label 

Defines  the  syntax  or  structure  of  an  arbitrary  string 
of  characters .  $ALL  matches  all  characters  in  the 
command  line  ( left-to-right )  until  any  one  of  a  set  of 
specified  terminating  characters  is  detected.  The  set 
of  terminating  characters  are  specified  with  the 
TERMINATORS  macro.  The  label  is  a  label  on  the 
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TERMINATORS  macro.  The  text  parsed  from  the  input  DCL 
command  line  that  fits  the  structure  defined  by  $ALL  is 
copied  to  an  IFORM  character  buffer  that  is  attached  to 
the  last  queued  mapping  number. 

Here  is  an  example  of  $ALL  with  the  TERMINATORS  macro : 


AND. 


<  $ ALL , EXCEPT  > 


EXCEPT:  TERMINATORS  1 "  ')  ']  $EOL 


$EOL 


$COP, * lit 


$DSB 


$ESB 


$DDR 


$EDR 


This  example  allows  the  " , "  the  " ) " ,  and  the  ]  as 
terminators,  in  addition  to  the  $EOL  predefined  syntax 
element,  discussed  next. 

$EOL  is  used  to  parse  end-of-line  characters.  For 
instance,  in  the  previous  example,  a  carriage-return  or 
escape  would  also  be  acceptable  as  a  terminator. 

$COP  does  not  define  syntax.  $COP  instructs  the  parser 
to  copy  the  specified  literal,  'lit,  unconditionally  to 
an  IFORM  character  buffer.  The  IFORM  character  buffer 
is  always  attached  to  the  last  queued  mapping  number. 

$DSB  (disable  skip  blanks)  does  not  define  syntax. 
$DSB  instructs  the  parser  not  to  skip  blanks . 
Normally,  blanks  are  ignored.  $DSB  and  $ESB  must  be  in 
the  same  syntax  element,  such  as  AND  or  OR,  but  need 
not  be  on  the  same  line. 

$ESB  (enable  skip  blanks)  does  not  define  syntax.  $ESB 
restores  the  default  state,  which  is  to  ignore  blanks. 

For  example,  a  file  specification  cannot  include 
blanks.  The  following  could  define  a  file 
specification: 

$DSB  $DEV  $UIC  <$ALFN, 0 , 9>  <$ALFN,0,3>  *  ?  <$ONUM,0,3>  $ESB 

(The  actual  file  specification  definition  is  more 
complex.  This  is  only  an  example.) 

$DDR  does  not  define  syntax.  $DDR  instructs  the  parser 
to  disable  delimiter  recognition.  Delimiter 
recognition  is  enabled  by  default  and  instructs  the 
parser  to  ensure  that  all  literal  syntax  elements  have 
delimiting  characters  terminating  them.  $DDR  must  be 
used  on  the  same  line  with  $EDR.  See  the  next  example. 

Enable  delimiter  recognition.  This  is  the  default 
case . 

For  example,  the  following  line  allows  you  to  attach 
the  first  one  to  three  characters  to  one  mapping  number 
while  the  remainder  are  attached  to  another. 
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$SEP 

$OSEP 

$CSEP 

$COSEP 

$FSEP 

$TERM 

$PROC 

$PRONC 

12.11.4 

You  can 
$NEW 

$RESET 

$FNAM 

$SY 

$TI 


C0M1 :  AND  $DDR  <$R50,1,3  MAP=1>  <$R50,0,7  MAP=2 >  $EDR 

END 

Notice  that  no  delimiting  character  distinguishes  the 
two  strings,  and  that  the  second  string  may  be  null, 

$SEP  defines  the  colon  ( : )  or  equals  (=).  These  are 
used  as  separators  between  qualifiers  and  arguments. 

$OSEP  defines  an  optional  separator,  that  is  colon, 
equals,  or  null. 

$CSEP  is  the  same  as  $SEP,  but  additionally  copies  a 
colon  to  the  I FORM . 

$C0SEP  is  the  same  as  $OSEP,  but  additionally  copies  a 
colon  to  the  IFORM  whether  anything  is  input  or  not. 

$FSEP  defines  the  comma  (,)  and  plus  (+)  as  file 
specification  separators . 

$TERM  defines  a  terminal  specification  and  copies  it  to 
the  IFORM. 

$PROC  defines  a  processor  name  for  the  Queue  Manager  as 
either  a  device  name  followed  by  a  colon  or  six 
Radix-50  characters  followed  by  a  colon. 

$PRONC  defines  a  processor  name  for  the  Queue  Manager 
as  a  device  name  followed  by  a  colon  or  six  Radix-50 
characters  not  followed  by  a  colon. 


Special  Translator  Elements 


specify  the  following  PSEs  only  in  a  TT. 

Used  to  indicate  the  start  of  an  additional  MCR  command 
line.  $NEW  instructs  the  dispatcher  subprocess  of  the 
DCL  task  that  there  are  multiple  MCR  commands  that  must 
be  dispatched  serially. 

Used  to  reset  the  IFORM  queue.  Resetting  the  IFORM 
queue  allows  all  used  mapping  numbers  to  be  reused. 
$ RESET  is  designed  to  be  used  with  $NEW  to  define 
multiple  MCR  commands. 

Used  to  specify  that  only  the  file  name  in  a  file 
specification  is  to  be  copied  to  the  MCR  command  line 
buffer  as  a  result  of  unmapping  a  mapped  file 
specification. 

Converts  the  assigned  device  for  SY:  to  ASCII  and 
appends  it  to  the  MCR  command  line;  for  example,  DB2 : . 

Converts  the  assigned  terminal  device  for  TI :  to  ASCII 
and  appends  it  to  the  MCR  command  line;  for  example, 
TT15 : . 
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$CUIC 

Converts  the  current  UIC  for  the  user  to  ASCII  and 
appends  it  to  the  MCR  command  line;  for  example, 
[301,113]. 

$LUIC 

Converts  the  login  UIC  for  the  user  to  ASCII  and 
appends  it  to  the  MCR  command  line. 

12.11.5  Program  Control  Elements 

You  can  specify  the  following  PSEs  in  either  a  PT  or  a  TT. 


$JSR, A 

A  special  category  used  to  gain  control  of  the  CPU. 
The  argument  A  must  be  the  label  of  a  MACRO-11 
subroutine.  To  indicate  failure,  the  MACRO-11 
subroutine  should  (on  return)  set  the  carry  bit  to 
indicate  failure  and  clear  it  to  indicate  success. 
Remember,  the  routine  must  be  in  the  blank  program 
section . 

$TST 

$TST  is  used  to  test  if  a  mapping  number  is  in  the 
I FORM  queue.  A  MAP  attribute  specifies  the  mapping 
number.  $TST  succeeds  only  if  the  mapping  number  is  in 
the  I FORM  queue;  for  example,  <$TST  MAP=1 > . 

$TSTN0T 

$TSTN0T  is  used  to  test  if  a  mapping  number  is  not  in 
the  I FORM  queue.  A  MAP  attribute  specifies  the  mapping 
number.  $TSTN0T  succeeds  only  if  the  mapping  number  is 
not  in  the  I FORM  queue.  The  syntax  is  identical  to 
$TST . 

$ LOAD, name 

$L0AD  is  used  to  load  an  overlay  from  a  parser  or 
translator  table.  The  argument  "name"  specifies  the 

name  of  the  overlay  as  specified  in  the  overlay 
description  file. 

$CALL0V, name 

$ CALLOV  is  used  to  load  and  activate  part  of  either  a 
parser  or  translator  table.  The  starting  address 
within  the  overlay  must  be  contained  in  the  first  word 
of  the  overlay.  Use  .WORD  to  specify  the  address.  On 
return,  the  previous  overlay  is  loaded.  The  argument 
"name"  specifies  the  name  of  the  overlay  as  specified 
in  the  overlay  description  file. 

$NULL 

$NULL  is  used  to  execute  attributes  without  specifying 
a  syntax  element.  $NULL  succeeds  if  the  attributes 
succeed. 

$AB 

$AB  (angle  bracket)  is  equivalent  to  the  literal  "<" 
and  is  used  to  pass  the  "<"  as  an  argument  to  MACRO-11. 

$BA 

$BA  is  equivalent  to  the  literal  ">"  and  is  used  to 
pass  the  ">"  as  an  argument  to  MACRO-11. 
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12.11.6  Example  from  DCL  Command  Tables 


.TITLE  ASSIGN 
. I DENT  /00/ 

.PSECT  . C  0  E  F 
.  ENABL  l.C 

9 

i  THIS  SOFTWARE  IS  FURNISHED  UNDER  A  LICENSE  AND  MAY 
r  BE  USED  OR  COPIED  ONLY  IN  ACCORDANCE  WITH  THF  TFRMS 
y  OF  SUCH  LICENSE. 

P 

y  COPYRIGHT  (c)  1981  BY  DIGITAL  EQUIPMENT  CORPORATION. 
i  ALL  RIGHTS  RESERVED. 

9 

J ♦ M ♦  SALMAN 


9  author: 

9 

9  date: 

9 

9  modified: 

9 

9  function: 


07-0CT-80 

DATE  ABSTRACT 


TRANSLATE  THE  DCL  COMMANDS  'ASSIGN',  'ASSIGN/QUEIJE',  ' ASSIGN/ RFDIRFCT 
'ASSIGN/TASK'  TO  THE  SEMANTICALLY  EQUIVALENT  MCR  COMMANDS  '  A  S  N '  ,  'QlJE 
'RED',  'REA'. 


MAPPING  LET TER/ NUMBER 


9 

THE  FOLLOWING  TABLE 

DEFINFS  THE  MAPPING  OF  THF 

DC!.. 

9 

DCL  SYNTAX  ELEMENT 

MCR  SYNTAX  ELEMFNT 

MAP 

9 

9 

<  q  u  e  u  e  n  a  m  e  > 

<  «  u  e  u  en a m e  > 

PI 

9 

<  p  r  o  c  e  s  s  o  T'  ri  a  in  e  > 

<  p  T'ncess  o  i'  n  a  m  e  > 

P2 

9 

<  olddevice > 

<  o  I  d  d  e  v  i  c  e  > 

P3 

9 

<  newdevice > 

<n0wd0vi.ee> 

P4 

9 

<  t  a  s  k  n  a  m  e  > 

<  task,  n  a  iti  e  > 

P5 

9 

<device> 

<  d  e  v  i.  e  e  > 

P6 

7 

9 

<  1  un> 

<  1  u  ri  > 

P7 

9 

<device> 

<  d  e  v  i  c  e  > 

PS. 

9 

<  lexica  .1.  d  0  v  i  c  e  > 

< logical d  e  vice  > 

P9  ♦ 

9 

/GLOBAL. 

/  G  B  L 

P 1 0 

9 

/LOGIN 

/LOGIN 

P 1 1 

9 

/TERMINAL- < t  e  r  m  d e v  > 

/TERM-Cter m d  0  v  > 

PI  7 

assign: : 


queue: 


redir: 


task: 


.PAGE 

OR 

END 

AND 

AND. 

END 

AND 

AND. 

END 

AND 

AND. 

AND. 

END 


CQUEIJF  B  S  -  B 1  >  CRFDIR  BS-B2>  <  TASK  BS  =  B3>  CLOG  DEV  BS-B4> 

'/  < ' QUEUE , 1 >  CfPRONC  MAP-1  PRO-$QNMSG  F R R - $ B Q M S G > 

< $ P R 0 C  M  A  P  -  2  P R 0  =  $ P R M S G  ERR-$IPMSG> 

'/  < ' RED  I RECT , 1 >  <$ODEVE  MAP-3  PRO-$FRMSG> 

< $ 0 D E V E  MAP-4  PRO-*TOMSG> 

'/  < ' T A S K , 2 >  $OSEP  <$R50,1,6  MAP-5  PRO-$TKMSG  ERR-$ITMSG > 
< $ 0 D E V E  MAP-6  PRO  =  $DVMSG> 

<$DNUM  ,1,5  MAP-7  PRO-UtJMSG  ERR-$NFMSG  > 
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♦TITLE  ASSIGN 
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$QDEVE  MAP~S  ♦  PRO=$DVMSG>  <$ODEVE  MAP=9*  PRO  DMSG>  QUA  = 


LOGDEV:  AND 

<$ODEVF.  MAF'=f) .  PRO 

END 

QUALt  OR 

<' GLOBAL, 1  MAF’  =  1  0  ♦ 

OR  ♦ 

< '  LOCAL  » 3  CBM=B1> 

OR* 

< ' LOGIN » 3  MAF'  =  1  1 .  i 

OR* 

< '  SYSTEM  , 1  MAF’  =  1 0  . 

OR* 

<*TERh  MAF’  =  12 .  CBM 

END 

♦  PAGE 


MCRASNt  t 


OR 

<QUE  BST  =  B1 >  <RED  BST  =  B2>  <RF A 

END 

que: 

AND 

« 'QUE  » 
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CHAPTER  13 


POOL  MONITORING  SUPPORT 


Pool  monitoring  support  controls  the  use  of  the  system’s  dynamic 
storage  region  (pool).  This  support  monitors  pool  levels,  restricts 
use,  and  notifies  you  when  pool  is  near  depletion.  This  support 
consists  of  two  parts:  the  RSX-11M/M-PLUS  Executive  pool  monitor 
code,  and  the  privileged  Pool  Monitor  Task  ( PMT ) . 

Pool  monitoring  support  is  not  available  on  unmapped  systems. 


13.1  HOW  YOU  GET  POOL  MONITORING  SUPPORT 

On  RSX-11M  systems,  you  receive  pool  monitoring  support  when  you 
select  the  pool  monitoring  support  option  in  system  generation 
(SYSGEN).  If  you  select  the  option,  you  receive  the  Executive  pool 
monitor  code  and  SYSGEN  assembles  and  task-builds  PMT.  If  you  do  not 
select  the  option,  you  do  not  receive  any  pool  monitoring  support. 

On  RSX-11M-PLUS  systems,  pool  monitoring  support,  including  the 
Executive  pool  monitor  code  and  PMT,  is  included  by  default.  SYSGEN 
establishes  the  support  for  you.  You  need  not  select  any  option  for 
it. 

One  of  PMT 1 s  features  is  that  it  responds  to  extreme  fragmentation. 
Due  to  the  seriousness  of  this  pool  problem,  PMT  requires  your 
interaction  to  aid  in  system  recovery.  Therefore,  if  you  select  pool 
monitoring  support,  you  must  be  prepared  to  respond  to  PMT's  prompts 
(see  Section  13.3.4). 


13.2  THE  EXECUTIVE  POOL  MONITOR  CODE 

The  pool  monitor  code  within  the  Executive  monitors  the  amount  of  free 
pool  and  detects  major  pool  events.  When  a  major  pool  event  occurs, 
the  Executive  notifies  PMT  of  the  event  and  of  the  current  condition 
of  pool . 


13.2.1  Pool  Events  Affecting  the  Executive 

The  Executive  pool  monitor  code  responds  to  three  major  pool  events. 
One  is  classified  as  a  high  pool  event  and  two  are  classified  as  low 
pool  events .  The  occurrence  of  these  events  directly  affects  the 
condition  of  pool,  creating  either  a  high  or  low  pool  condition.  The 
Executive  responds  by  notifying  PMT  of  the  pool  event  and  the 
resultant  pool  condition  and  also  activates  PMT.  Any  further  response 
to  the  pool  condition  is  left  to  PMT. 
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13.2.1.1  High  Pool  Event  -  The  following  is  the  possible  high  pool 
event : 

•  The  attainment  of  a  high  pool  condition  from  a  low  pool 
condition . 

This  event  occurs  when  a  system  that  has  a  low  pool  condition 
relinquishes  enough  pool  to  cause  the  amount  of  free  pool  to  rise 
above  the  high  limit. 

The  high  pool  limit  is  set  using  the  MCR  and  VMR  SET  /PLCTL  command. 
See  Section  13.4  for  further  discussion  of  the  high  limit. 


13.2.1.2  Low  Pool  Event  -  The  following  are  the  possible  low  pool 
events : 

•  The  degradation  of  pool  from  a  high  pool  condition  to  a  low 
pool  condition 

•  A  pool  allocation  failure 

The  degradation  of  pool  occurs  when  the  total  amount  of  free  pool  has 
fallen  below  the  low  limit.  A  pool  allocation  failure  occurs  when  the 
largest  pool  fragment  is  too  small  for  the  process  requesting  it .  A 
pool  allocation  failure  is  not  to  be  confused  with  future  discussions 
in  this  chapter  of  pool  fragmentation.  Pool  allocation  failures  and 
pool  fragmentation  are,  in  the  context  of  this  chapter,  different  pool 
problems  and  are,  therefore,  discussed  separately.  See  Section  13.3.1 
for  additional  information  on  pool  fragmentation. 

The  low  pool  limit  is  set  using  the  MCR  and  VMR  SET  /PLCTL  command. 
See  Section  13.4  for  further  discussion  of  the  low  limit. 


13.2.1.3  Pool  Monitoring  Interface  -  The  mechanism  used  by  the 
Executive  to  detect  pool  events  is  called  the  pool  monitor  interface. 
The  details  of  how  this  interface  works  are  beyond  the  scope  of  this 
manual.  However,  it  is  fully  described  in  the  source  code  for  the 
Executive  module  CORAL. MAC.  CORAL. MAC  is  in  [11,10]  on  your  kit.  In 
summary,  the  interface  functions  as  follows: 

•  Provides  the  Executive  with  the  ability  to  declare  information 
to  a  pool  monitor  task. 

•  Provides  the  Executive  with  the  capability  to  receive  a 
response  or  acknowledgement  from  a  pool  monitor  task.  (An 
acknowledgement  can  be  used  by  the  Executive  to  control 
further  information  declarations . ) 


13.2.2  Pool  Conditions 

The  condition  of  pool  is  directly  related  to  major  pool  events  and 
also  to  the  acceptable  high  and  low  pool  limits  you  specify.  (You  set 
and  manipulate  these  limits  using  either  the  MCR  or  VMR  SET  /PLCTL 
command  described  in  Section  13.4).  When  a  major  pool  event  occurs 
and  causes  the  size  of  free  pool  to  cross  the  low  or  high  limit,  a  new 
pool  condition  exists.  The  possible  pool  conditions  are  low  pool  and 
high  pool . 
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A  high  pool  condition  exists  when  the  amount  of  free  pool  is 
sufficient  to  support  current  and  less  demanding  system  workloads. 

A  low  pool  condition  exists  when  the  amount  of  free  pool  is  nearing 
the  point  where  system  performance  will  degrade  seriously  if  the 
system's  workload  increases. 

Major  pool  events  cause  either  a  high  or  low  pool  condition  to  exist. 
In  turn,  a  high  or  low  pool  condition,  combined  with  a  specific  pool 
fragmentation  level,  creates  either  a  high  or  low  pool  state.  Pool 
states  are  discussed  in  Section  13.3. 


13.3  THE  POOL  MONITOR  TASK 

The  Pool  Monitor  Task  ( PMT )  is  task  built  and  installed  during  the 
SYSGEN  procedure.  Whenever  the  resultant  system  is  bootstrapped,  PMT 
is  activated  by  the  Executive. 

(If  you  do  not  wish  to  use  the  DIGITAL-supplied  Pool  Monitor  Task,  you 
do  have  the  option  to  write  and  run  your  own  pool  monitor  task.  If 
you  wish  to  write  your  own  pool  monitor  task,  you  should  first  be 
familiar  with  the  Executive  pool  monitor  interface.  The  interface  is 
documented  in  the  Executive  module  [ 11 , 10]CORAL .MAC .  A  task,  with  the 
task  name  "PMT...",  installed  on  a  system  that  supports  pool 
monitoring,  is  considered  to  be  a  "pool  monitor  task".) 

PMT's  first  responsibility  is  to  monitor  pool  conditions.  The 
conditions  that  PMT  responds  to  include  those  detected  and  reported  by 
the  Executive  (see  Section  13.2).  PMT's  second  responsibility  is  to 
monitor  pool  fragmentation.  Through  this  monitoring,  PMT  can  respond 
to  another  major  pool  event  and  also  react  to  extreme  pool 
fragmentation.  The  other  major  pool  event  (not  reported  by  the 
Executive)  occurs  when  PMT  detects  that  the  largest  free  pool  fragment 
is  less  than  the  minimum  required  fragment  size.  (See  Section  13.3.4 
for  further  discussion  of  extreme  fragmentation.) 

Once  it  has  been  activated  by  the  Executive,  PMT  basically  operates  in 
a  cycle.  PMT  determines  the  size  of  the  largest  pool  fragment 
whenever  it  receives  the  Executive's  notification  of  a  pool  condition, 
or  at  least  at  regular  time  intervals.  It  then  compares  this  size  to 
the  minimum  required  fragment  size.  Based  on  the  Executive's  report 
on  the  current  pool  condition  and  what  PMT  detects  when  monitoring 
fragmentation,  PMT  determines  what  the  current  state  of  pool  is  and 
responds  to  it  accordingly. 

The  minimum  required  fragment  size  is  set  using  the  MCR  and  VMR  SET 
/PLCTL  command.  See  Section  13.4  for  further  discussion  of  the 
minimum  required  fragment  size. 


13.3.1  Conditions  Affecting  PMT 

PMT  responds  to  pool  fragmentation  and  to  pool  conditions;  however, 
the  response  varies  depending  upon  the  current  level  of  pool 
fragmentation.  The  two  levels  that  influence  PMT's  response  are  as 
follows : 

1.  If  the  largest  fragment  is  equal  to  or  greater  than  the 
minimum  required  fragment  size,  PMT  then  acts  only  on  the 
condition  of  pool  as  reported  by  the  Executive. 
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2.  If  the  largest  fragment  becomes  smaller  than  the  minimum 
required  fragment  size,  PMT  considers  this  to  be  a  low  pool 
event.  If  the  system  is  not  already  in  a  low  pool  state, 
this  event  causes  a  transition  to  that  state.  PMT  then 
responds  accordingly. 

Although  extreme  fragmentation  is  another  pool  event  that  PMT  responds 
to,  it  is  different  from  those  previously  described.  It  is  defined 
and  documented  in  Section  13.3.4. 

PMT  uses  the  information  it  has  concerning  the  current  level  of 
fragmentation  and  also  the  information  provided  by  the  Executive  to 
determine  the  overall  state  of  pool.  Following  is  a  discussion  of 
PMT's  response  to  specific  pool  events  and  conditions. 


13.3.1.1  Pool  Level  and  Fragment  Size  Are  Satisfactory  -  The 
Executive  notifies  PMT  that  the  pool  level  is  above  the  high  limit  and 
PMT  detects  that  fragment  size  is  greater  than  the  minimum  required 
fragment  size. 

PMT  concludes  that  a  high  pool  state  exists  and  executes  actions 
appropriate  for  a  high  pool  state  (see  Section  13.3.2). 


13.3.1.2  Low  Pool  Condition  -  The  Executive  notifies  PMT  that  a  low 
pool  condition  is  achieved. 

PMT  determines  whether  the  change  in  pool  reported  by  the  Executive  is 
temporary.  The  change  is  temporary  if,  by  the  time  PMT  responds  to 
the  Executive's  notification,  enough  free  pool  has  accumulated  to  push 
the  total  above  the  high  limit.  If  the  change  is  temporary,  PMT 
ignores  the  notification  and  continues  to  execute  high  pool  state 
actions.  If  the  change  is  not  temporary,  PMT  concludes  that  a  low 
pool  state  exists  and  executes  actions  appropriate  for  a  low  pool 
state  (see  Section  13.3.3). 


13.3.1.3  High  Pool  Condition  -  The  Executive  notifies  PMT  that  a  high 
pool  condition  is  achieved. 

PMT  determines  whether  the  change  in  pool  reported  by  the  Executive  is 
temporary.  The  change  is  temporary  if,  by  the  time  PMT  responds  to 
the  Executive's  notification,  the  total  amount  of  free  pool  has  moved 
below  the  high  limit.  If  the  change  is  temporary,  PMT  ignores  the 
notification  and  continues  to  execute  low  pool  state  actions.  If  the 
change  is  not  temporary,  PMT  initiates  actions  appropriate  for  a  high 
pool  state  (see  Section  13.3.2). 


13.3.1.4  Largest  Pool  Fragment  Is  Too  Small  -  PMT  detects  that  the 
largest  pool  fragment  is  smaller  than  the  minimum  required  fragment 
size . 

PMT  concludes  that  a  low  pool  state  exists  and  executes  actions  for  a 
low  pool  state.  Note  that  this  low  pool  state  overrides  any  pool 
conditions  reported  by  the  Executive.  This  pool  event  will  cause  the 
system  to  be  in  a  low  pool  state  even  if  the  Executive  reports  a  high 
pool  condition. 
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13.3.1.5  Largest  Pool  Fragment  Becomes  Larger  -  PMT  detects  that  the 
required  ira^en^ze^01  £rag”ent  h"  ba<=°"e  ‘“9“  <*»»  «» 

PMT  decides  that  the  current  pool  state  must  be  based  on  the  latest 
pool  condition  reported  by  the  Executive.  If  the  Executive  reported  a 
high  pool  condition,  PMT  decides  that  a  high  pool  state  exists.  If 
the  Executive  reported  a  low  pool  condition,  PMT  decides  that  a  low 

«?Lf?or  eithSr  SltU“i0n-  PMT  th*  *PPr°Prl«te 


13.3.2  PMT  Default  Actions  for  a  High  Pool  State 

When  PMT  concludes  that  a  high  pool  state  exists,  it  executes  the 
following  actions : 

1.  Sets  its  internal  cycle  interval  to  1  minute 

2.  Enables  checkpointing  for  itself 

3.  Removes  any  pool  use  controls 

PMT  then  stops  itself  so  that  its  impact  on  system  resources  is 
minimized.  PMT  unstops  itself  when  the  internal  cycle  interval  has 
elapsed. 


13.3.3  PMT  Default  Actions  for  a  Low  Pool  State 

When  PMT  concludes  that  a  low  pool  state  exists,  it  executes  the 
following  actions: 

1.  Disables  checkpointing  for  itself. 

2.  Sets  its  internal  cycle  interval  to  20  seconds. 

3.  Establishes  pool  use  controls  as  follows: 

a.  Prevents  nonprivileged  users  from  logging  in. 

b.  Suppresses  INS TALL /RUN /REMOVE  sequences  on  nonprivileged 
terminals . 

c.  Delays  nonprivileged  task  loading. 

NOTE 

Nonprivileged  tasks  with  a  task  priority  less 
than  the  specified  base  priority  cannot  compete 
for  memory  resources  until  a  high  pool  state 
exists  (see  Section  13.4.3).  This  does  not  mean 
that  such  tasks  cannot  be  requested;  they  will 
simply  remain  blocked  from  execution  until  PMT 
concludes  that  a  high  pool  state  exists.  All 
other  tasks,  including  any  tasks  already  active 
at  the  onset  of  the  low  pool  state,  are  not 
affected  by  this  control. 
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d.  Sends  a  warning  message  to  all  logged-in  terminals  (or 
on-line  terminals  on  systems  without  multiuser 
protection).  This  message  cannot  be  suppressed  by  the 
MCR  SET  /NOBRO  command  or  the  DCL  SET  TERM  /NOBROADCAST 
command . 

e.  Sends  a  warning  message  to  and  displays  pool  statistics 
at  the  console  terminal. 


13.3.3.1  PMT  Output  to  Terminals  During  Low  Pool  State  -  When  PMT 
determines  that  a  low  pool  state  exists,  PMT  sends  the  following 
warning  message  to  logged— in  terminals  (or  on-line  terminals  on 
systems  without  multiuser  protection): 

08-AUG-85  13:35:10  --  Low  pool  --  Please  exit  active  tasks  -  7FPHYR 

The  effectiveness  of  this  message  depends  on  whether  users  exit  from 
their  active  tasks.  If  they  choose  to  ignore  this  message,  a  low  pool 
state  continues  to  exist. 

ZEPHYR  is  the  system  name  selected  during  SYSGEN  or  the  DECnet  node 
name  (if  DECnet  is  running  on  your  system). 

PMT  sends  this  message  at  20-second  intervals  until  it  concludes  that 
a  high  pool  state  exists . 


13.3.3.2  PMT  Output  to  the  Console  Terminal  During  Low  Pool  State  - 
In  a  low  pool  state,  PMT  also  sends  a  warning  message  to  and  displays 
pool  statistics  at  the  console  terminal.  The  following  is  an 
annotated  example  of  PMT  output  to  the  console  terminal: 

08-AUG-85  1.3:35:1.0  —  Warning  “Pool  is  critically  low  Q 
Total  free  pool  =  1116*  bytes  © 

Largest  fragment  =  .1.1.2*  bytes  © 

In  this  example,  PMT: 

©  Sends  a  warning  message 

0  Displays  the  amount  of  free  pool  existing  at  the  onset  of 
the  low  pool  state 

©  Displays  the  size  of  the  largest  free  fragment  of  pool 
existing  at  the  onset  of  the  low  pool  state 

PMT  broadcasts  this  message  at  20— second  time  intervals  until  it 
concludes  that  a  high  pool  state  exists. 


13.3.4  PMT  Default  Actions  for  Extreme  Fragmentation 

Extreme  fragmentation  exists  when  the  largest  pool  fragment  is  less 
th^n  84 (decimal)  bytes.  In  this  case,  pool  is  exhausted  and  it  is  not 
possible  to  free  any  pool  by  unsolicited  terminal  input,  for  example, 
issuing  an  ABORT  command.  At  this  point,  PMT  takes  immediate  action 
to  prevent  total  pool  depletion  by  executing  the  following  steps: 

1.  Enters  kernel  mode,  which  prevents  any  other  tasks  from 
executing  but  does  allow  the  system  to  respond  to  device 
interrupts . 
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2.  Prevents  the  invocation  of  TKTN .  (Invoking  TKTN  at  this  time 
depletes  the  available  pool.)  It  does  this  by  clearing  TKTN ' s 
special  TCB  pointer  that  is  stored  within  the  Executive. 

3.  Sends  a  warning  message  to  the  console  terminal. 

4.  Prompts  you  to  abort  one  or  more  of  the  tasks  displayed. 
(You  must  be  at  the  console  to  free  pool  in  response  to  the 
PMT  prompts.)  After  you  select  a  task  to  abort,  PMT  returns 
to  user  mode  until  the  abort  operation  is  finished. 

5.  Displays  a  message  at  the  terminal  running  the  task  and  the 
console  terminal  if  the  task  is  successfully  aborted. 

6.  Displays  (upon  request)  an  updated  list  of  abortable  tasks  at 
the  console  terminal. 

(On  RSX-11M  systems  84 (decimal)  bytes  is  the  size  of  a  CLI  command 
buffer . ) 


13.3.4.1  Abortable  Tasks  -  The  abortable  task  list  includes  only 
those  tasks  that  PMT  considers  eligible  to  abort.  A  task  is  abortable 
if  it  meets  the  following  requirements: 

•  It  must  be  active. 

•  It  must  be  resident  in  memory. 

•  It  cannot  be  privileged  and  running  from  the  console  terminal. 

•  It  cannot  be  a  Command  Line  Interpreter  (CLI)  task. 

•  It  cannot  be  an  Ancillary  Control  Processor  (ACP)  task. 

•  It  cannot  be  the  task  loader. 

•  It  cannot  have  any  internal  conditions  that  prevent  it  from 
exiting  upon  an  abort  request  (for  example,  it  is  already 
aborted ) . 

The  ability  to  abort  tasks  included  in  this  list  is  a  powerful  feature 
and  one  that  is  potentially  harmful  to  your  system.  You  should  abort 
tasks  that  consume  pool  and  are  relatively  expendable.  This  action 
should  release  pool  resources  for  use  by  the  remaining  active  tasks 
and  allow  the  system  to  continue  operation,  rather  than  deadlock  over 
pool  resources . 

It  is  important  that  you  use  discretion  when  selecting  tasks  to  abort. 
Aborting  certain  tasks  could  render  all  or  part  of  the  application 
unusable.  You  can  abort  certain  tasks  (for  example,  PIP  or  MAC)  and 
experience  relatively  few  side  effects.  As  an  added  measure  of 
protection  for  your  system,  PMT  does  not,  by  default,  include  in  the 
abortable  task  list  the  privileged  tasks  running  from  the  console 
terminal.  Therefore,  if  it  is  possible,  you  should  run  the  privileged 
tasks  that  you  do  not  want  considered  abortable  (by  PMT)  from  the 
console  terminal . 
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13.3.4.2  PMT  Messages  -  When  extreme  pool  fragmentation  occurs,  PMT 
displays  a  message  in  the  following  format  and  a  list  of  abortable 
tasks  at  the  console  terminal : 

dd-mmm-yy  hh:mm:ss  —  Warning  —  Free  pool  exhausted 
Abortable  tasks  in  memory: 

tttttt  P  l/0=xxx.  ttnn : 

where : 

tttttt  The  name  of  the  abortable  task 

p  The  indicator  that  the  task  is  privileged  (a  blank  means 

that  it  is  nonprivileged) 

xxx  The  total  outstanding  I/O  count  for  the  task 

ttnn  The  terminal  where  the  task  is  running  from 

PMT  lists  the  tasks  in  order  of  decreasing  priority  but  does  not 
display  the  priority  of  individual  tasks. 

PMT  then  prompts  you  to  select  one  of  the  tasks  from  the  list  as 

follows : 

E  n  t  e  r  a  t  a  s  k  t  o  a  b  o  r  t  ?  o  r  p  r  e  s  s  R  F  T  U  R  N  t  o  e  x  :i  t  * 

If  the  task  you  specify  is  not  installed  or  not  on  the  list  of 

abortable  tasks,  PMT  displays  one  of  the  following  messages: 

T  a  s  k  n  o  t  :i.  n  s  t  a  11  e  d  ?  t  r  *  a  sal  n  l 

T  3  s  k  n  o  b  a  b  o  r  t  e  d  ?  t  r  s  a  3  a  i  n  t 

PMT  displays  the  list  of  abortable  tasks  if  you  press  LINE  FEED  in 
response  to  either  prompt.  If  you  press  RETURN,  PMT  relinquishes 
control  of  the  system,  by  returning  to  user  mode,  for  at  least  seven 
seconds,  giving  the  system  an  opportunity  to  recover  from  the  low  pool 
state  unassisted. 

If  PMT  is  not  able  to  abort  the  task  you  specify  and  the  task  is 

listed  as  abortable,  PMT  displays  the  following  message  (this  occurs 
only  if  the  task  exits  before  PMT  is  able  to  abort  it): 

T  3  s  fe  ri  o  t  a  b  c»  r  t  a  d  ?  i  r  y  a  d  a  i.  n  ♦ 

If  PMT  successfully  aborts  the  task,  it  sends  the  following  message  to 
the  console  terminal: 

"  1 1 1 1 1 1 "  t  o  r  t  e  d 

Also,  if  the  task  was  not  running  from  the  console  terminal,  PMT 
displays  the  following  messages  at  the  terminal  where  the  task  is 
running  from: 

G8-AUG-85  13*3f>il0  Warning  --  Free  pool  exhausted 
"  1 1 1 1 1 1 H  a  b  o  p  t  e  d 

PMT  then  sends  the  following  message  to  the  console  terminal: 

Press  LINE  FEED  for  an  updated  task  list? 
enter  a  task  to  abort?  or  press  RETURN  to  exit* 
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13.3.4.3  Annotated  Example  of  PMT  Output  for  Extreme  Fragmentation  - 
An  annotated  example  of  PMT  output  for  extreme  fragmentation  is  shown 
in  the  following  example.  The  numbers  in  the  example  correspond  to 
the  numbered  items  in  the  list  that  follows  Example  13-1. 


Example  13-1  PMT  Output  for  Extreme  Fragmentation 

b :■  6 U G z 8 5  13142123  rr  Uaroind  zz  Eree  kgdI  exhausted  Q 
u  b  o  r  it  3  b  1 0  ;t  3  s  k  s  in  ui  0  &  o  x'  y  1 


RMDEMQ  1 

e:  i/q? 

0,. 

IIQ1 

COT.*.*,  i 

?  I/Os 

Q.i. 

1 1 01 

61x130  E 

?  I  ZDs 

1.*. 

II 301 

EDII14 

I/Qs 

1.*. 

1 114 1 

d  6 1 T  2  0 

I/Os 

1* 

1 1 201 

JEST 

I/Os 

0* 

CO  01 

RIET21 

I/Os 

L 

1121 1 

M4CI47 

1/Qs 

1.*. 

1142 1 

Euter  a  task,  to  abort*  or  sress  REIUBN  to  exit!  PIPT21  0 

.1.  E I B  T  2 1  ‘  aborted  O 

Ejcess  LINE  EEELi  for  an  uadaied  task,  list* 

enter  a  task,  to  abort*  or  Kress  RETURN  to  eixitl  @  © 

6  b  o  r  table  Las  k  a  i  □  memo  .r  y  1  @ 


RtiDENQ 

E 

I/Os 

0,. 

II 01 

C  Q I  x  a 

P 

I/Qs 

Qx 

1 1 01 

61x130 

E 

I/Os 

lx 

1 1 301 

ED1I14 

I/Qs 

lx 

II 141 

b6II20 

I/Qs 

lx 

1 1 201 

I  ESI 

I/Qs 

Ox 

CO  01 

M6CI47. 

I/Os 

lx 

II 421 

Etiiiter  a  task  to  aborts.  or  Brass  REIURN  to  eaitl  EDT  © 
I  ask  oot  i  n  s  :t  a  1 1  e  d  ?  t  r  y  asai  a  1  E  D I T 1 4  © 

■EDII14*.  aborted  © 

Ejcess  LINE  FEED  for  an  updated  task  list* 

euter  a  task  to  abort.*,  or  press  RETURN  to  EXIT!  ® 


In  this  example,  PMT: 

O  Sends  a  warning  message  to  logged-in  terminals  (or  on-line 
terminals  if  the  system  does  not  support  multiuser 
protection) . 

©  Displays  the  list  of  abortable  tasks  at  the  console 
terminal . 

©  Prompts  for  a  task  to  abort  (PIPT21  is  entered). 

©  Aborts  "PIPT21 " . 

©  Prompts  for  an  updated  task  list,  a  task  to  abort,  or  an 
exit.  (A  LINE  FEED  is  entered  for  an  updated  task  list.) 
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Displays  the  list  of  abortable  tasks . 

Prompts  for  a  task  to  abort  (EDT  is  entered). 

Indicates  that  a  task  with  the  name  "EDT"  is  not  installed, 
and  requests  that  you  try  again  (EDIT14  is  entered) . 

©  Aborts  "EDIT14". 

(J?)  Prompts  for  an  updated  task  list,  a  task  to  abort,  or  an 
exit.  (The  RETURN  key  is  pressed  for  an  exit.) 


13.3.5  PMT  Task-Build  Options 

You  can  modify  PMT's  response  to  pool  conditions  by  editing  PMT  s 
task-build  file  PMTBLD.CMD  and  task  building  PMT  again.  If  you  wish 
to  modify  PMT,  you  must  do  the  following: 

1.  Remove  PMT  (the  task  name  is  PMT...)  by  using  VMR 

2.  Edit  the  task-build  file 

3 .  Task  build  PMT  again 

4.  Install  the  modified  task  image  by  using  VMR 

When  the  system  is  rebooted,  the  new  PMT  task  will  begin  executing. 
If,  however,  you  want  the  modified  task  image  to  run  immediately,  you 
must  first  abort  PMT  before  you  remove  and  reinstall  it  using  MCR  or 
DCL. 

You  can  modify  the  following  PMT  features: 

•  Timing  control 

•  Actions 

•  Pool  use  controls 

The  specifics  of  modifying  PMTBLD.CMD  are  documented  in  the  file 
itself.  Following  is  a  discussion  of  the  PMT  features  that  you  can 
modify. 


13.3.5.1  Controlling  PMT  Timing  -  PMT  basically  operates  in  a  cycle. 
It  becomes  unstopped  at  regular  intervals  to  monitor  fragmentation  and 
then  stops  itself.  When  the  Executive  interrupts  the  cycle  to  report 
a  new  pool  event,  PMT  resets  the  cycle  to  begin  at  the  point  at  which 
it  was  interrupted . 

PMT's  cycle  can  have  one  of  two  possible  time  lengths.  The  length 
depends  on  the  current  state  of  pool.  If  a  low  pool  state  exists,  the 
cycle  is  20  seconds  long  (plus  the  time  PMT  requires  to  execute  all 
low  pool  state  actions).  If  a  high  pool  state  exists,  the  cycle  is  60 
seconds  long  (plus  the  time  PMT  requires  to  execute  all  high  pool 
state  actions). 

You  can  modify  PMT's  cycle;  however,  the  only  modification  allowed  is 
lengthening  the  high  pool  state  cycle.  The  60-second  value  is  not 
only  the  default  value  but  also  the  minimum  value  that  you  can 
specify.  If  you  lengthen  the  cycle,  PMT  may  not  be  as  effective  at 
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monitoring  pool  fragmentation  problems.  You  can  partially  compensate 
for  this,  by  using  the  SET  /PLCTL  command  (see  Section  13.4.2)  to 
increase  the  minimum  size  of  the  largest  pool  fragment  parameter. 
This  ensures  that  PMT  will  detect  imminent  pool  fragmentation  problems 
earlier . 


13.3.5.2  Controlling  PMT  Action  -  You  can  modify  some  of  the  actions 
that  PMT  executes  during  the  cycle.  The  actions  are  as  follows: 

•  Sending  warning  messages  to  logged-in  terminals  (or  on-line 
terminals  on  systems  that  do  not  support  multiuser  protection) 

•  Forcibly  checkpointing  stopped  tasks  in  memory 

•  Aborting  certain  privileged  tasks 

When  a  low  pool  state  exists,  PMT  sends  warning  messages  to  logged-in 
terminals  (or  on-line  terminals  on  systems  that  do  not  support 
multiuser  protection).  You  can  suppress  this  action  by  modifying 
PMTBLD.CMD  and  task  building  PMT  again. 

When  a  low  pool  state  exists,  PMT  requests  the  Executive  to  forcibly 
checkpoint  all  memory-resident  stopped  tasks  without  outstanding 
nonbuffered  I/O.  These  tasks  include  CLI  tasks,  ACP  tasks,  and  tasks 
with  outstanding  buffered  I/O,  only  if  they  are  stopped  during  a  low 
pool  state.  When  the  Executive  checkpoints  a  task,  it  deallocates  the 
task  header,  thereby  reducing  fragmentation. 

You  can  modify  PMTBLD.CMD  to  enable  such  checkpointing  for  a  high  pool 
state  as  well.  This  reduces  the  effect  of  long-term  fragmentation, 
making  it  more  likely  that  a  long-lived  data  structure  will  be 
allocated  to  a  lower  address  within  pool.  This  clusters  the 
long-lived  data  structures  together,  leaving  larger  blocks  of  free 
pool  available  for  more  dynamic  types  of  allocation.  Although  this 
can  increase  the  effective  use  of  available  pool  space,  it  also  causes 
a  noticeable  increase  in  disk  I/O  as  tasks  are  checkpointed.  CLI 
tasks,  ACP  tasks,  and  tasks  with  outstanding  buffered  I/O  are  exempt 
from  checkpointing  while  a  high  pool  state  exists. 

The  remaining  option  concerns  PMT ' s  list  of  abortable  tasks.  During 
extreme  fragmentation,  PMT  displays  a  list  of  abortable  tasks  and 
prompts  for  tasks  to  abort.  By  default,  PMT  does  not  list  or  abort 
privileged  tasks  running  from  the  console  terminal.  You  can  override 
this  default  by  modifying  PMTBLD.CMD.  There  are,  however,  exceptions 
to  this  option.  These  exceptions,  CLI  tasks,  ACP  tasks,  and  the  task 
loader,  are  never  listed  by  PMT  as  abortable  tasks. 


13.3.5.3  Controlling  Pool  Use  -  When  a  low  pool  state  is  in  effect, 
PMT  executes  the  default  pool  use  controls  described  in  Section 
13.3.3.  You  can  suppress  any  of  these  controls  by  modifying 
PMTBLD.CMD  and  task  building  PMT  again. 


13.3.6  Aborting  PMT 

If  you  wish  to  terminate  PMT,  you  can  easily  abort  it.  You  must  do 
one  of  the  following  to  abort  PMT: 

•  Issue  an  ABORT  command  from  a  privileged  terminal 

•  Issue  an  Abort  directive  from  a  privileged  task 
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When  you  select  either  o£  these  methods.  PMT  performs  the  following 
actions  before  it  exits: 

•  Restores  TKTN's  special  TCB  pointer  if  PMT  previously  cleared 
the  pointer  and  TKTN  is  still  installed  (see  Section  13.3.4). 
This  restores  normal  TKTN  operations . 

•  Prevents  the  Executive's  pool  monitor  code  from  requesting  PMT 
after  PMT  exits.  This  is  done  by  clearing  the  special  TCB 
pointer  for  PMT...  as  set  by  MCR  INSTALL,  DCL  INSTALL,  and 
VMR  INSTALL  commands. 

•  Cancels  any  outstanding  pool  use  controls  that  it  may  have 
imposed  because  of  a  low  pool  state. 

•  Displays  the  following  message  at  the  console  terminal: 

R  e  rft  o  v  e  a  n  d  r  e  i.  u  t  o  1  It  P  M  F  t  o  r  e  s  t  o  r  e  p  o  o  1  hi  o  r  i  i.  t o  r  i  1 1 
M  PMT * ♦ ♦ "  aborted 

This  indicates  that  PMT ' s  special  TCB  pointer  has  been  cleared 
so  that  the  Executive  can  no  longer  request  PMT  to  run.  To 
restore  the  pointer/  you  must  remove  and  reinstall  PMT  using 
MCR  or  DCL. 


13.4  THE  SET  / PLCTL  COMMAND 

The  SET  /PLCTL  command  sets  the  pool  limit  parameters  used  by  the 
Executive  pool  monitor  code  and  PMT.  The  syntax,  parameters,  and 
parameter  limits  for  the  command  are  discussed  in  Chapter  10  and  also 
in  the  RSX-11M/M-PLUS  MCR  Operations  Manual.  Basic  guidelines  for 
setting  the  four  command  parameters  are  discussed  in  the  following 
subsections . 

During  a  low  pool  state,  you  can  compare  the  values  you  set  and  the 
information  that  is  output  to  the  console  terminal  (see  Section 
13.3.3.2)  to  determine  whether  the  parameters  require  further 
modification. 


13.4.1  Low  and  High  Pool  Limits 

The  first  two  parameters  of  the  SET  /PLCTL  command  establish  the  low 
and  high  pool  limits.  The  Executive  pool  monitor  code  uses  these 
limits  to  determine  when  major  pool  events  occur. 

In  general,  you  should  set  the  low  limit  value  to  the  least  desirable 
pool  level.  This  is  a  limit  where  your  system's  workload  cannot 
increase  without  the  risk  of  a  pool  resource  deadlock.  The 
appropriate  value  for  this  limit  varies  with  each  system.  You  can 
determine  the  best  value  by  experimenting  with  various  limits.  The 
low  limit  defaults  to  600 (decimal)  bytes. 

Set  the  high  limit  value  to  reflect  the  type  of  use  your  system 
receives.  The  high  limit  parameter  essentially  controls  the  point 
where  a  low  pool  state  is  transformed  into  a  high  pool  state.  The 
high  limit  defaults  to  1600 ( decimal )  bytes. 
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If  pool  use  fluctuates  considerably,  a  limit  set  relatively  higher 
than  the  low  limit  will  tend  to  reduce  the  number  of  pool  state 
transitions.  If  pool  use  is  typically  constant,  a  high  limit  set 
close  to  the  low  limit  will  quickly  show  critical  changes  in  the  pool 
state.  Since  pool  needs  and  use  vary,  you  should  experiment  with  this 
parameter  to  determine  the  optimum  value. 


13.4.2  Pool  Fragment  Size 

This  parameter  establishes  the  minimum  size  of  the  largest  pool 
PMT  uses  this  limit  to  determine  when  pool  fragmentation 
problems  exist.  When  the  largest  pool  fragment  is  the  minimum  size  or 
greater ,  a  high  pool  state  exists  —  as  far  as  fragmentation  is 
concerned.  A  low  pool  state  exists  when  the  largest  pool  fragment  is 
smaller  than  the  minimum  size.  The  lowest  permissible  size  of  the 
largest  pool  fragment  is  200 (decimal)  bytes  by  default.  You  should 
experiment  with  this  parameter  to  judge  the  optimum  value. 

Fragmentation  is  one  of  the  more  frequent  and  less  desirable  pool 
problems.  Thus,  the  value  that  you  specify  for  this  parameter  can 
have  an  immediate  impact  on  successful  pool  monitoring. 


13.4.3  Base  Priority  for  Nonprivileged  Tasks 

This  parameter  establishes  the  base  priority  for  nonprivileged  tasks . 
The  optimum  value  of  this  parameter  is  application  specific,  but 
defaults  to  51 (decimal).  During  a  low  pool  state,  PMT  uses  this 
parameter  to  restrict  newly  requested  nonprivileged  tasks  from 
competing  for  memory  resources  (see  Section  13.3.3).  Only  those  tasks 
with  a  priority  less  than  the  specified  base  priority  are  so 
restricted . 
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The  Shuffler  (SHF)  is  a  privileged  task  designed  to  compact  space  in 
system-controlled  partitions  when  a  memory  allocation  failure  occurs. 
The  Shuffler  operates  only  within  system-controlled  partitions  and  is 
available  for  the  RSX-11M/M-PLUS  operating  systems,  but  is  not 
available  for  unmapped  systems  or  for  RSX-11S. 

This  copter  describes  Shuffler  interaction  with  the  operating  system. 
Briefly,  it  describes  system-controlled  partitions.  In  more  detail, 
it  describes  Shuffler  structure,  ways  to  monitor  the  Shuffler,  and 
Shuffler  algorithms  for  the  operating  system. 


14.1  EXECUTIVE  AND  MEMORY  USAGE 

Memory  is  the  processor  storage  medium  in  which  the  Executive  and 
tasks  reside  when  executing.  The  Executive  is  the  kernel  of  the 
operating  system  that  interfaces  the  hardware  system  with  other 
components  of  the  operating  system  and  with  the  user. 

The  Executive  brings  a  task  into  memory  for  execution  and  places  the 
task  in  competition  with  other  active  tasks.  When  tasks  are  brought 
into  memory,  they  are  placed  in  a  section  of  memory  called  a 
partition.  Partitions  are  contiguous  areas  of  memory  in  which 
executable  tasks  run;  however,  a  common  partition  may  be  defined  that 
contains  only  data  or  code. 

RSX-11M-PLUS  supports  only  system-controlled  partitions. 

RSX-11M  supports  three  types  of  partitions: 

1.  System-controlled  partitions 

2.  User-controlled  partitions 

3 .  Common  partitions 

User-controlled  partitions  and  system-controlled  partitions  are  used 
to  load  waiting  tasks.  User— controlled  partitions  accommodate  only 
one  task  at  a  time.  If  you  want  to  run  multiple  tasks  within  a 
user-controlled  partition,  you  must  define  multiple  subpartitions. 

System-controlled  partitions  accommodate  as  many  tasks  as  possible  at 
any  one  time.  The  Executive  allocates  available  space  in 

system-controlled  partitions  and  creates  the  dynamic  subpartition  for 
each  task. 

On  RSX-1 1M-PLUS ,  tasks,  device  drivers,  dynamic  common  regions,  and 
static  common  regions  reside  in  subpartitions  of  the  system-controlled 
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partition.  Static  common  regions  are  resident  libraries  and  resident 
commons  and  both  may  be  shared  by  tasks  for  more  efficient  use  of 
physical  memory.  Resident  libraries  contain  code,  and  resident 
commons  contain  data. 

On  RSX-11M,  static  common  regions  must  be  loaded  into  common 
partitions.  A  common  partition  is  a  dedicated  area  of  memory  that  may 
be  shared  by  tasks.  Tasks,  device  drivers,  and  dynamic  common  regions 
created  by  memory  management  directives  must  be  loaded  into 
subpartitions  of  the  system-controlled  partition. 


14.1.1  System-Controlled  Partitions 

Only  mapped  systems  support  system-controlled  partitions .  A  mapped 
system  is  a  system  with  memory  management.  A  task  in  a  mapped  system 
can  run  in  any  system-controlled  partition  large  enough  to  contain  it, 
and  the  Executive  is  responsible  for  allocating  space  in  that 
partition.  Refer  to  the  RSX-11M/M-PLUS  MCR  Operations  Reference 
Manual  for  detailed  information  on  system-controlled  partitions  and 
memory  management . 

The  Executive  allocates  dynamic  memory  space  for  waiting  tasks  in  the 
following  manner: 

1.  Uses  a  priority  level  of  1  through  250  to  determine  a  waiting 
task's  use  of  a  system-controlled  partition.  A  higher  number 
indicates  a  higher  priority. 

2.  Begins  at  the  base  of  the  partition  and  searches  for  a  free, 
contiguous  area  large  enough  for  the  waiting  task. 

3.  Creates  a  dynamic  subpartition  within  the  system-controlled 
partition. 

4.  Eliminates  the  subpartition  to  free  memory  when  the  task  has 
finished  execution. 

In  some  instances,  a  waiting  task  cannot  be  loaded  into  a 
system-controlled  partition  because  there  is  not  enough  memory  space 
available.  If  there  is  not  enough  space  to  load  a  waiting  task,  the 
Executive  uses  checkpointing  to  make  memory  space  available  to  the 
waiting  task. 

To  make  room  for  a  waiting  task,  the  Executive  searches  the 
system-controlled  partitions  for  one  or  more  tasks  with  a  lower 
priority  than  that  of  the  waiting  task.  The  Executive  then 
checkpoints  (moves)  the  task  of  lower  priority  from  memory  to  disk  to 
make  room  for  the  waiting  task  of  higher  priority.  The  checkpointed 
task  is  immediately  placed  in  competition  with  other  tasks  waiting  for 
residency.  When  the  checkpointed  task  is  reloaded,  it  continues 
processing  from  the  point  where  it  was  interrupted. 

On  RSX-11M-PLUS ,  the  Executive  keeps  track  of  outstanding  I/O  on  a 
partition-by-partition  basis.  Thus,  the  Executive  may  checkpoint 
subpartitions  with  dynamic  common  regions,  static  common  regions,  and 
task  regions  if  there  is  no  I/O  pending. 

On  RSX-11M,  the  Executive  keeps  track  of  outstanding  I/O  on  a 
task-by-task  basis.  The  Executive  cannot  easily  determine  to  which 
partition  outstanding  I/O  is  directed.  Therefore,  RSX-11M  can  only 
checkpoint  subpartitions  with  task  regions .  Common  partitions  and 
dynamic  common  regions  created  by  memory  management  directives  cannot 
be  checkpointed. 
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14.1.2  Partition  Fragmentation 

Checkpointing  does  not  always  create  enough  memory  space  to  load  a 
waiting  task.  This  is  a  result  of  partition  fragmentation. 
Fragmentation  in  system-controlled  partitions  occurs  when  tasks  of 
various  sizes  are  entering  and  exiting  memory,  or  when,  for  example, 
device  drivers  are  loaded  in  the  middle  of  a  system— controlled 
partition.  Device  drivers,  which  cannot  be  checkpointed,  often  create 
space  between  subpartitions  and  below  subpartitions  called  fragments . 

Tasks  with  nonbuffered,  outstanding  I/O  cause  fragmentation  of 
system-controlled  partitions.  Such  tasks  cannot  be  checkpointed.  The 
Executive  must  wait  for  the  task's  I/O  count  to  reach  zero  before  the 
task  can  be  checkpointed.  While  the  Executive  waits  for  the  task's 
I/O  count  to  reach  zero,  the  task  is  blocked  from  execution  to  prevent 
the  task  from  issuing  more  I/O  requests  that  could  delay  the  loading 
of  the  waiting  task.  The  following  lists  the  serious  causes  of 
fragmentation  in  system-controlled  partitions: 

1.  Device  drivers  loaded  in  the  middle  of  a  system-controlled 
partition 

2.  Subpartitions  that  are  connected  to  the  IP11  driver 

3.  Subpartitions  that  are  connected  to  an  interrupt  vector  by 
means  of  a  CINT$  directive 

4.  Subpartitions  with  nonbuffered,  long-outstanding  I/O,  and 
whose  I/O  count  has  not  yet  dropped  to  zero 

5 .  Regions  that  have  been  fixed  by  the  Executive  for  a  memory 
parity  error 

6.  Dynamic  regions  created  by  PLAS  directives  (RSX-11M  only) 

If,  for  any  reason,  including  fragmentation,  the  Executive  is  unable 
to  load  a  waiting  task  into  a  subpartition,  the  Executive  requests  the 
Shuffler.  The  Shuffler  moves  subpartitions  in  system-controlled 
partitions  in  an  attempt  to  create  the  free  space  necessary  to  load  a 
waiting  task.  Thus,  the  Executive  requests  the  Shuffler  only  when  all 
other  attempts  to  load  a  waiting  task  fail. 


14.2  SHUFFLER  PERFORMANCE 

The  Shuffler  is  approximately  700 (decimal)  words  and  can  be  installed 
only  on  a  mapped  system.  The  Shuffler  is  installed  during  system 
generation  by  a  VMR  command  and  by  default  is  built  for  the  partition 
SYSPAR,  which  can  also  be  used  by  the  MCR  dispatcher  and  TKTN.  Refer 
to  the  RSX-11M  or  RSX-1 1M-PLUS  System  Generation  and  Installation 
Guide  for  more  information  on  installing  the  Shuffler. 

The  overhead  incurred  for  the  Shuffler  task  is  found  in  the  Shuffler, 
not  in  the  Executive.  The  Shuffler  responds  well  on  a  system  if  there 
are  fewer  tasks  loaded  in  memory  and  if  the  Shuffler  does  not  execute 
frequently.  If  you  have  a  heavily  loaded  system,  the  Shuffler  may 
execute  more  than  you  want  because  of  repeated  memory  allocation 
failures.  If  the  Shuffler  executes  frequently  on  your  system,  better 
performance  is  obtained  when  the  Shuffler  is  fixed  in  its  own 
partition  where  it  does  not  have  to  compete  with  MCR  and  TKTN  for 
memory. 

The  word,  $SHFTM,  in  the  Executive's  system  common  area  limits  the 
number  of  times  the  Shuffler  may  be  requested  within  a  time  interval. 
$SHFTM  heightens  the  Shuffler's  effectiveness  on  your  system.  Each 
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time  the  Executive  requests  the  Shuffler,  this  timer  is  checked.  If 
the  timer  registers  zero,  the  Shuffler  may  be  requested.  If  the  timer 
registers  a  positive  number,  the  request  for  the  Shuffler  is  ignored. 
The  amount  of  time  (clock  ticks)  that  must  elapse  before  the  Shuffler 
is  requested  again  is  stored  in  the  system  common  area,  $SHFCT.  When 
the  Shuffler  is  successfully  requested,  $SHFTM  is  initialized  for  the 
new  interval  with  the  value  stored  in  $SHFCT . 

If  you  are  a  privileged  user,  you  may  change  $SHFCT.  To  change 
$SHFCT,  you  need  a  copy  of  RSX11.MAP,  the  Executive  map  produced 
during  system  generation.  Using  the  map,  you  must  determine  the 
address  of  the  global  symbol  $SHFCT.  You  can  change  the  contents  of 
the  system  $SHFCT  with  the  MCR  OPEN  command.  The  Shuffler  is 
requested  infrequently  if  the  value  is  set  too  high.  If  the  value  is 
set  too  low  (zero),  system  response  may  decrease  because  the  Shuffler 
is  being  requested  too  frequently. 


14.2.1  Monitoring  The  Shuffler 

Several  memory  allocation  failures  during  peak  usage  periods  result  in 
the  repeated  request  of  the  Shuffler.  The  repeated  execution  of  the 
Shuffler  can  produce  a  noticeable  decrease  in  response  time.  You  may 
monitor  the  Shuffler's  effect  on  your  system  by  using  RMD.  RMD  is  a 
privileged  task  that  displays  information  concerning  task  activity  on 
the  operating  system.  Refer  to  Chapter  6  for  a  detailed  explanation 
of  RMD. 

If  you  want  to  monitor  Shuffler  activity  with  RMD,  you  must  dedicate  a 
video  terminal  on  which  to  run  the  RMD  display •  The  key  features  to 
monitor  on  the  memory  display  page  are  as  follows: 

•  The  currently  executing  task;  *IDLE*  indicates  that  no  task  is 
executing 

•  The  number  of  active  tasks  in  memory  and  the  amount  of  memory 
they  occupy,  plus  the  number  of  active  tasks  checkpointed  (on 
disk)  and  the  total  memory  they  would  require. 

These  features  show  task  activity.  If  the  Shuffler  is  active,  tasks 
are  moving  down  in  the  partition,  and  the  currently  executing  task 
field  registers  the  Shuffler  as  the  active  task. 

Occasionally,  the  Shuffler  registers  as  the  active  task,  but  tasks 
cannot  be  seen  moving  down  in  the  partition.  To  verify  that  tasks  are 
not  moving  when  the  Shuffler  is  executing,  check  the  number  of  active 
tasks  checkpointed  (on  disk)  and  the  number  of  tasks  waiting  for 
memory.  If  this  count  remains  the  same  over  a  period  of  time,  the 
Shuffler  is  executing  but  cannot  create  enough  space  for  waiting 
tasks.  Thus,  the  Shuffler  is  using  too  much  of  the  system's 
resources.  If  the  system  does  not  recover,  it  might  be  better  to 
abort  the  Shuffler  from  your  system. 

If  the  Shuffler  task  continues  to  use  too  much  of  the  system's 
resources,  you  should  remove  the  Shuffler  from  your  system  with  the 
MCR  REMOVE  command. 


14.3  THE  SHUFFLER  ALGORITHMS 

When  a  memory  allocation  failure  occurs,  the  Executive  requests  the 
Shuffler.  The  Shuffler  searches  memory  for  a  system-controlled 
partition  that  has  at  least  one  task  waiting  for  space.  When  the 
Shuffler  locates  such  a  system-controlled  partition,  it  attempts  to 
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move  (shuffle)  subpartitions  in  the  memory  partition  to  create  the 
continuous  area  necessary  to  load  waiting  tasks. 

On  RSX-11M,  the  Shuffler  can  only  shuffle  task  subpartitions.  Because 
RSX-11M  does  not  maintain  an  outstanding  I/O  count  on  a 
partition-by-partition  basis,  the  Shuffler  cannot  determine  whether 
outstanding  I/O  is  pending  to  a  common  partition  or  a  dynamic  common 
region.  Thus,  the  Shuffler  does  not  shuffle  common  partitions  or 
subpartitions  with  dynamic  common  regions  created  by  memory  management 
directives . 

On  RSX-11M-PLUS ,  the  Shuffler  does  shuffle  common  regions  because  an 
outstanding  I/O  count  is  maintained  on  a  partition-by-partition  basis. 
Thus,  subpartitions  containing  static  common  regions  or  dynamic  common 
regions  can  be  shuffled  when  there  is  no  I/O  pending. 

The  Shuffler  uses  two  algorithms  to  move  subpartitions  in  memory. 
Each  algorithm  executes  several  steps  repeatedly  until  the  partition 
reaches  a  stable  state. 


14.3.1  The  First  Pass  Algorithm 

In  the  first  pass,  the  Shuffler  attempts  to  move  each  subpartition  to 
the  base  of  the  partition.  When  subpartitions  are  moved  to  the  base 
of  the  partition,  free  space  is  created  at  the  top  of  the  partition  so 
that  a  waiting  task  can  enter  memory  if  there  is  enough  space. 
Shuffling  occurs  in  the  following  steps: 

1.  The  Shuffler  requests  the  Executive  to  unconditionally 

checkpoint  all  stopped  checkpointable  subpartitions  and 

checkpointable  subpartitions  that  have  been  blocked  with  a 
CLI  command . 

2.  The  Shuffler  attempts  to  move  each  subpartition  to  the  base 

of  the  partition  and  blocks  each  executable  task  from  further 
execution.  If  a  subpartition  has  outstanding  I/O,  the 
Shuffler  waits  for  the  task's  nonbuffered,  outstanding  I/O 
count  to  reach  zero.  If  the  I/O  count  does  not  reach  zero  in 
approximately  .5  seconds,  the  Shuffler  marks  the  subpartition 
as  having  outstanding  I/O,  and  restarts  the  first  pass 

algorithm.  The  Executive  clears  the  subpartition's  I/O 

indicator  when  the  task's  I/O  count  becomes  zero. 

3.  The  Shuffler  moves  each  task  to  the  base  of  the  partition. 

If  the  subpartition's  I/O  count  reaches  zero  within  30 

seconds . 

4.  Each  subpartition  is  unblocked  to  allow  further  execution 
after  shuffling  is  complete,  and  the  free  space,  now  above 
the  subpartition,  is  deallocated. 

Be  aware  that  a  fixed  task  can  be  shuffled.  If  you  do  not  want  to 
have  a  fixed  task  shuffled,  you  must  fix  this  task  in  a 
user-controlled  partition  or  in  its  own  dedicated  system-controlled 
partition . 

If  fragmentation  has  not  occurred  at  the  end  of  the  first  pass,  it 
means  the  Shuffler  has  successfully  merged  the  free  space  in  the 
partition  into  one  continuous  area  at  the  top  of  the  system-controlled 
partition.  A  task  may  then  be  loaded  into  memory  if  there  is  enough 
space  available. 
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However,  memory  space  may  not  be  available  if  there  are  several  tasks 
already  loaded  in  memory,  or  if  fragmentation  is  dividing  the 
system-controlled  partition  into  two  or  more  partition  sections.  A 
partition  section  is  a  subset  of  the  area  in  a  system-controlled 
partition.  Each  partition  section  is  flanked  on  at  least  one  side  by 
a  subpartition  that  cannot  be  shuffled.  For  example,  if  a  device 
driver  is  loaded  in  the  middle  of  a  system-controlled  partition,  the 
system-controlled  partition  is  divided  into  two  partition  sections 
because  a  device  driver  is  a  subpartition  that  cannot  be  moved. 

If,  during  the  first  pass  algorithm,  the  Shuffler  encounters  a 
subpartition  that  cannot  be  moved,  the  Shuffler  begins  to  shuffle 
subpartitions  that  can  be  moved  to  the  base  of  the  partition  section 
that  bounds  it.  The  Shuffler  cannot  shuffle  subpartitions  around  a 
subpartition  that  cannot  be  moved.  Therefore,  if  fragmentation  has 
occurred  during  the  first  pass,  the  system-controlled  partition  is 
divided  into  two  or  more  partition  sections,  and  the  free  space  in  the 
partition  may  no  longer  be  merged  at  the  top  of  the  partition,  but 
rather  at  the  top  of  the  partition  section. 

The  Shuffler  initializes  the  second  pass  algorithm  if  enough  memory 
space  is  not  available  for  waiting  tasks,  or  if  fragmentation  has 
divided  the  system-controlled  partition  into  several  partition 
sections .  Little  memory  space  or  partition  sections  prevent  the 
Shuffler  from  accumulating  all  the  free  space  at  the  top  of  the 
partition.  The  free  space  in  each  partition  section  is  separate  and 
cannot  be  merged  with  the  free  space  in  another  partition  section. 


14.3.2  Second  Pass  Algorithm 

The  second  pass  algorithm  is  executed  once  for  each  partition  section 
within  a  system-controlled  partition.  This  pass  attempts  to  create  a 
reverse  priority  list  of  subpartitions  that  can  be  checkpointed  by  the 
waiting  task. 

During  the  second  pass,  the  Shuffler  creates  a  list  in  ascending 
priority  order  of  the  subpartitions  in  each  partition  section.  The 
Shuffler  then  compares  the  size  of  the  waiting  task  with  the  sum  of 
free  space  in  the  partition  section  plus  the  total  of  one  or  more 
lower  priority,  checkpointable  tasks.  If  the  waiting  task  is  smaller, 
the  Shuffler  requests  the  Executive  to  checkpoint  the  lower  priority 
task ( s )  . 

Checkpointing  the  lower  priority  task(s)  may  create  new  space,  but  the 
new  space  may  not  comprise  a  continuous  area  in  memory.  The  Executive 
may  begin  the  first  pass  algorithm  to  accumulate  the  free  space  of  the 
partition  section.  The  free  space  is  then  allocated  to  the  waiting 
task.  As  long  as  there  are  subpartitions  that  cannot  be  moved  in  a 
system-controlled  partition,  memory  is  still  divided  into  two  or  more 
partition  sections . 

If  the  Shuffler  completes  the  second  pass  without  finding  room  for  a 
waiting  task,  the  Shuffler  searches  for  the  next  system-controlled 
partition  with  waiting  tasks.  If  there  are  no  other  system-controlled 
partitions  with  tasks  waiting  for  memory  space,  the  Shuffler  exits. 
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RSX-11M-PLUS  SYSTEM  RECONFIGURATION 


A  reconf igurable  system  is  a  system  in  which  you  can  add  or  remove 
system  resources  such  as  memory  and  devices.  Reconfiguration  is  a 
means  of  physically  and  logically  connecting  and  disconnecting  various 
resources.  This  chapter  discusses  the  purpose  and  application  of 
reconfiguration,  and  describes  the  components  and  commands  of  the 
reconfiguration  services. 

System  reconfiguration  is  available  only  on  RSX-11M-PLUS  systems. 

Some  of  the  information  in  this  chapter,  however,  applies  only  to 
multiprocessor  systems.  Blue  ink  is  used  to  distinguish  this 
information. 


15.1  THE  RECONFIGURATION  SERVICES 

The  reconfiguration  services  allow  you  to  reconfigure  an  RSX-11M-PLUS 
system  to  bypass  faulty  hardware  elements  and  to  isolate  the  system 
from  the  effects  of  these  elements. 

With  the  reconfiguration  services,  you  can  define  a  set  of  hardware 
resources  that  are  accessible  from  the  on-line  system  and  also  remove 
devices  from  the  pool  of  resources  allocated  to  the  on-line  system. 
For  example,  after  bootstrapping  the  system,  you  can  place  a  failed 
disk  drive  off  line  and  then  use  another  drive  that  is  already  on  line 
or  place  one  on  line  to  take  over  for  the  disabled  unit. 


15.1.1  Reconfiguration  Components  (CON, RD: ,HRC) 1 

You  reconfigure  system  resources  by  using  together  a  command  interface 
(CON),  a  loadable  driver  (RD:),  and  a  privileged  reconfiguration  task 
(HRC).  CON  and  HRC  must  have  enough  checkpoint  space  allocated  for 
them  both  to  be  resident  in  memory  at  the  same  time.  If  the  operating 
system  cannot  load  both  tasks  at  the  same  time,  CON  commands  will 
fail . 

CON,  as  the  command  interface,  receives  and  parses  the  commands  that 
you  issue  to  reconfigure  the  current  system.  CON  then  creates  and 
submits  QIO  packets  to  the  reconfiguration  driver  (RD:). 

RD:,  the  reconfiguration  driver,  serves  as  an  interface  between  a  user 
task  (either  CON  or  a  user  application  task)  and  the  HRC  task;  it  is 
the  gateway  between  tasks  that  generate  reconfiguration  requests  and 
the  actual  implementation  of  those  requests.  RD:  accepts  QIO  packets 


1.  DIGITAL  will  accept  SPRs  regarding  the  interface,  but  reserves  the 
right  to  treat  such  SPRs  as  informational  only. 
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from  any  task  and  places  these  packets  into  the  receive  queue  of  HRC.* 
Before  passing  the  QIO  packets  to  HRC,  RD:  performs  privilege  and 
address  boundary  checks  on  them.  The  checks  ensure  that  the  Pa<*ets 
are  using  valid  addresses  and  legal  function  codes,  and,  for 
functions,  that  RD;  is  attached  to  them. 

hrc  the  privileged  reconfiguration  task,  performs  the  actual 
reconfiguration  operations  for  the  system.  To  process  reconfiguration 
requests,  HRC  calls  Executive  routines,  which  then  call  the  associated 
device  drivers.  HRC  services  the  requests  for  configuration 
information  by  passing  the  desired  information  directly  to  the 
buffer . 


After  HRC  services  the  request,  a  status  is  returned  (by  means  of  I/O 
completion)  to  the  requesting  task.  The  status  return  was  implemented 
in  part  to  allow  tasks  other  than  CON  to  interface  with  HRC. 

The  data  base  for  each  system  device  contains  status  words  that 
reflect  device  state.  When  you  change  a  system  device  state,  HRC 
modifies  the  appropriate  data  base  status  word  to  either  grant  or 
inhibit  device  access. 


15.1.2  Device  States 

The  RSX-11M-PLUS  system  reconfiguration  services  control  the 
configuration  state  (on  line  or  off  line)  of  the  hardware  devices  and, 
therefore,  control  device  access.  A  system  device  can  assume  one  of 
four  states: 

1.  On  line  -  device  on  line,  access  granted 

2.  Off  line  -  device  off  line,  access  denied 

3.  Marked  for  on  line  -  device  will  be  brought  on  line  when 
access  path  exists,  access  denied 

4.  Marked  for  off  line  -  indeterminate  state,  access  denied 


In  the  on-line  state,  a  device  is  logically  on  line  for  access.  This 
state  indicates  that  an  access  path  exists  between  the  device  and  an 
on-line  processor  and  that  a  call  (if  any)  to  the  driver’s  controller 
or  unit  status  change  entry  points  was  successful.  RSX-11M-PLUS 
grants  access  to  on-line  devices  only.  To  access  an  on-line  disk  or 
tape  volume  and  perform  virtual  I/O  on  it  (for  example,  read  or 
write  operations  to  files),  the  volume  must  be  mounted.  (See  the 
RSX-11M/M-PLUS  MCR  Operations  Manual  or  the  RSX-1 1M-PLUS  Command 
Language  Manual  for  a  description  of  volume  access  rights  and  mounted 
volumes . ) 


1.  Note  that  programs  written  to  use  the  current  version  of  RD;  may 
have  to  be  modified  in  the  next  release.  You  should  centralize  all 
code  concerning  RD:  so  that  modifications  can  be  made  easily. 

Because  of  the  likely  changes,  RD:  has  not  been  documented.  For  some 
information,  check  the  reconfiguration  sources  located  in  UFD  [27,10] 
of  the  distribution  kit  (except  the  RL02  kit,  which  does  not  contain 
any  sources).  Important  modules  for  the  interface  are  CNHRC ,  HROOT , 
and  HRSUB .  (See  also  the  macro  0LRDF$  in  [1 , 1 ]EXEMC .MLB  for  a 
description  of  volume  access  rights  and  mounted  volumes . ) 
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When  a  device  is  in  the  off-line  state,  the  system  denies  access  to 
the  device.  Attempts  to  access  an  off-line  device  result  in  an  I/O 
error  (IE.OFL).  (See  the  RSX-11M/M-PLUS  and  Micro/RSX  I/O  Operations 
Reference  Manual  for  lists  and  explanations  of  error  codes . )  Taking  a 
controller  off  line  also  takes  all  of  its  associated  units  off  line, 
which  places  the  units  in  the  marked  for  on-line  state. 

The  marked  for  on-line  state  indicates  that  a  request  to  bring  a 
device  or  controller  on  line  has  been  made,  but  part  of  the  access 
path  to  the  device  or  controller  is  off  line.  Access  attempts  yield 
the  error  code  IE.OFL.  HRC  places  a  device  marked  for  on  line 
logically  on  line  when  it  brings  the  entire  access  path  on  line. 

The  marked  for  off-line  state  indicates  that  the  system  encountered  an 
unexpected  error  in  attempting  to  place  a  specific  device  logically  on 
line.  You  must  issue  an  explicit  off-line  command  before  attempting 
or  retrying  an  on-line  operation. 


15.1.3  Placing  Devices  Logically  On  Line  and  Off  Line 

To  place  a  device  logically  on  line,  HRC  first  verifies  that  the 
device  driver  is  loaded  (for  loadable  drivers  only)  and  then  tests 
whether  the  controller  can  access  the  device  (the  controller  must  be 
on  line).  If  the  controller  can  access  the  device  (an  access  path 
exists),  HRC  modifies  the  appropriate  status  word  to  reflect  that  the 
device  is  on  line.  If  the  controller  or  device  cannot  be  accessed, 
HRC  marks  the  device  for  on  line  and  then  places  the  device  on  line 
when  the  access  path  is  brought  on  line. 

Before  placing  a  device  off  line,  HRC  attempts  to  protect  against 
inadvertent  loss  or  possible  corruption  of  data  by  verifying  that  the 
state  change  will  not  interfere  with  active  I/O.  HRC  considers  a 
device  active  and  rejects  off-line  commands  if  the  device  has  context. 
The  reconfiguration  services  define  device  context  as  a  condition  that 
indicates  (or  permits)  I/O  activity  on  the  device.  The  following  is  a 
list  of  conditions  that  define  device  context: 

•  A  task  is  attached  to  the  device  (for  example,  the  print 
despooler  attaches  the  line  printer) . 

•  The  device  (or  an  associated  device)  is  a  logged-in  terminal. 

•  The  device  (or  an  associated  device)  contains  a  mounted 
volume . 

•  For  the  DT07  bus  switch,  a  port  is  logically  connected  to  a 
processor  ( linked) . 

•  For  memory  boxes,  the  memory  within  the  box  is  logically  on 
line  (multiprocessor  systems  only) . 

•  A  disk  device  has  data  caching  enabled. 

You  cannot  take  a  controller  off  line  if  any  of  the  units  on  the 
controller  have  context. 

For  dual-port  disks  (RK06/RK07,  RM02/RM03/RM05/RM80/RP07 ,  and 

RP04/RP05/RP06 ) ,  which  have  each  port  connected  to  a  different 
controller,  you  can  place  off  line  one  path  with  context  as  long  as 
the  alternate  path  is  on  line.  (See  the  description  of  the  OFFLINE 
command  for  more  information.) 
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15.2  INITIATING  THE  RECONFIGURATION  SERVICES 

You  reconfigure  an  RSX-11M-PLUS  system  interactively  from  a  terminal 
or  by  means  of  indirect  command  files.  The  reconfiguration  services 
act  as  an  interface  between  your  terminal  and  the  RSX-11M-PLUS  system. 

To  issue  a  reconfiguration  command,  type  a  command  line  in  response  to 
the  default  prompt  (>)  or  to  the  explicit  command  interface  prompt 
( CON > ) .  A  command  line  consists  of  three  components:  a  command  name, 
any  required  parameters,  and  a  line  terminator.  (Note  that  there  is 
no  DCL  command  to  access  CON.) 


15.2.1  Invoking  CON 

It  is  not  necessary  to  use  the  entire  command  name  when  issuing  a 
command  line;  CON  requires  only  the  first  three  characters  of  the 
name.  However,  to  make  the  intent  of  the  command  input  clear  to 
someone  reading  a  printed  copy,  you  can  use  the  entire  command  name. 
For  example,  you  can  issue  the  ONLINE  command  as  follows: 

Formats 

CON>ONL  dev- spec  ffl 


or 


CON > ONLINE  dev-spec  © 
dev-spec 

The  target  device . 


© 

The  RETURN  key  (the  line  terminator). 

A  space  or  tab  signals  the  end  of  the  command  name.  Therefore,  no 
spaces  or  tabs  are  permitted  within  the  name  itself.  To  use  the 
reconfiguration  services,  first  invoke  the  command  interface  CON  and 
then  issue  the  commands.  There  are  two  ways  to  invoke  CON 
interactively : 

1.  Use  the  one-line  format  to  invoke  CON,  execute  a  single 
command,  and  return  control  to  MCR.  For  example: 

H  C  R  >  C  0  N  c  o  m  m  a  n  d  -- 1  i  n  e  © 

2 .  Use  the  direct  task  format  to  invoke  CON  and  obtain  a  task 
prompt  (CON> ) .  For  example: 

M C  R > CON  © 

CUN> 

Type  CTRL/Z  to  exit  from  the  direct  task  format. 

You  can  also  enter  commands  through  indirect  command  files.  An 
indirect  command  file  that  contains  reconfiguration  commands  does  not 
require  terminal  interaction  when  the  file  is  executed.  Thus, 
indirect  command  files  are  a  convenient  means  of  creating 
configuration  command  sequences  that  create  different  configurations 
or  restore  previous  configurations . 
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For  examples 

M C R > C 0 N  ©CONFIG  (RET) 

This  command  line  invokes  CON/  executes  the  reconfiguration  commands 
contained  in  the  indirect  command  file  CONFIG. CMD,  and  returns  control 
to  MCR. 

The  following  command  line  executes  the  commands  in  the  file 
CONFIG . CMD  and  returns  control  to  CON: 

CON> (3 CONFIG  (ret) 

Indirect  command  files  can  be  nested  to  a  maximum  depth  of  three. 


15.3  CON  COMMAND  SUMMARY 

The  following  table  summarizes  the  reconfiguration  commands  and 
provides  a  compact  overview  of  the  commands.  Detailed  command 
descriptions  appear  in  alphabetical  order  in  Section  15.4. 


Table  15-1 
CON  Command  Summary 


BUILD 

CLEAR 

DISPLAY 

ESTATUS 

HELP 
I  DENT 

LINK 

LIST 

OFFLINE 


Creates  a  command  sequence  in  an  internal 
buffer  that/  if  executed/  duplicates  the 
current  system  configuration. 

Erases  the  command  sequence  created  by 
BUILD  (but  not  the  file  created  by  LIST) 
that  is  stored  in  the  internal  buffer  by 
CON. 

Displays  the  configuration  and  status  of 
the  hardware  devices  in  the  current 
system . 

Emits  the  current  status  of  a  specific 
device. 

Displays  the  help  text  for  CON. 

Displays  the  current  versions  of  CON  and 
HRC  and  the  date  and  time  the  two  tasks 
were  built. 

Logically  connects  a  port  of  a  switched 
bus  run  to  a  processor. 

Displays  the  results  from  a  BUILD  command 
or  puts  the  command  sequence  into  a 
specified  file.  A  file  type  of  .CMD  is 
suggested  because  that  is  the  default 
type  for  an  indirect  command  file. 

Removes  a  device  without  context  from  the 
active  set  of  devices  in  the  current 
configuration . 

(continued  on  next  page) 
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Table  15-1  (Cont.) 

CON  Command  Summary 

OFFLINE  MEMORY 

(Multiprocessor  systems  only.)  Removes 
the  memory  box  with  the  highest  addresses 
from  the  system.  Note  that  you  must 
first  ensure  that  nothing  is  using  the 
memory  in  the  memory  box . 

ONLINE 

Attempts  to  place  a  device  logically  on 
line . 

ONLINE  MEMORY 

(Multiprocessor  systems  only.)  Adds  a 
memory  box  to  the  on-line  configuration. 
Note  that  you  must  expand  the  partition 
structure  to  use  the  additional  memory. 

SET 

Alters  the  CSR  or  interrupt  vector 
address  values  of  a  device  and/  on 
multiprocessor  systems,  activates  or 
inhibits  the  sanity  timer  and  its  alarm. 

SWITCH 

(Multiprocessor  systems  only.)  Logically 
disconnects  a  port  of  a  switched  bus  run 
from  a  processor  and  then  connects  the 
port  to  another  processor.  The  command 
is  equivalent  to  a  LINK  command  followed 
by  an  UNLINK  command. 

UNLINK 

Logically  disconnects  a  port  of  a 

switched  bus  run  from  its  respective 
processor . 

CON  also  accepts  two  switches,  /HE  and  /NOMSG.  These  switches  are 
used  alone  in  the  CON  command  line.  Their  functions  are  as  follows: 


/HE 

Displays  the  help  text  for  CON. 

/NOMSG 

Suppresses  all  information  displays  and 
error  messages  returned  by  CON.  You  must 
exit  from  and  then  reenter  CON  to  have  the 
messages  displayed  again. 

RSX-11M-PLUS  SYSTEM  RECONFIGURATION 


BUI 


15.4  CON  COMMAND  DESCRIPTIONS 

This  section  describes  each  of  the  reconfiguration  commands.  Note 
that  some  of  the  commands  must  be  issued  from  a  privileged  terminal. 


BUILD 

The  BUILD  command  creates  a  sequence  of  commands  that,  when  executed, 
duplicates  the  current  system  configuration.  The  sequence  of 
reconfiguration  commands  resulting  from  a  BUILD  command  is  held  in  a 
buffer  in  memory.  When  this  sequence  of  commands  executes,  the 
reconfiguration  commands  restore  the  system  to  the  exact  state 
existing  when  the  BUILD  command  was  issued. 

Format 

C0N>BUI[LD] 


Example 

CON> BUILD 

This  command  creates  a  sequence  of  commands  that  duplicates  the 
current  system  configuration. 
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CLEAR 


CLEAR 

The  CLEAR  command  erases  from  the  internal  buffer  the  current  sequence 
of  commands  created  by  the  BUILD  command.  The  command  does  not  delete 
the  file  created  by  the  LIST  command  (described  later  in  this 
section) . 

Format 

CON > CLEAR 


Example 

CON> BUILD 
CON> CLEAR 

The  CLEAR  command  removes  from  the  internal  buffer  the  command 
sequence  resulting  from  the  previous  BUILD  command. 


15-8 


RSX-11M-PLUS  SYSTEM  RECONFIGURATION 


DIS 


DISPLAY 

I^„?IS^Y^C°™mand  ?rovides  current  system  configuration  information 
about  the  device  units,  device  controllers,  processors,  memory  boxes, 
and  memory  box  controllers.  1 

Format 


CON > DIS [PLAY]  [keyword ( s ) ]  [FOR  string] 

Keywords 

UNI [TS] 

Displays  every  device  unit  in  the  current  configuration. 
The  display  equates  each  device  unit  with  its  respective 
controller . 

CON [ TROLLERS ] 

Displays  every  device  controller  in  the  current 
configuration . 


FUL[L] 

Displays  the  status  flags  for  every  device  unit  and  device 
controller  in  the  current  configuration.  The  status  flags 
indicate  the  followings 


Accpath  The  device  has  an  on-line  access  path. 

Context  For  a  tape  or  disk  (mountable  device)/  the 

device  contains  a  mounted  volume.  For  a 
terminal/  a  user  is  logged  in.  Other  devices 
are  attached . 

Driver  For  a  device  unit,  the  driver  is  loaded.  For  a 

device  controller/  a  driver  is  available. 


Massbus  The  device  is  connected  to  an  RH  MASSBUS 

controller. 

Multiport  The  device  is  dual-ported  (a  dual-access 

device)  between  two  controllers  (for  example/  a 
dual-ported  RP06  drive). 


Offline 


The  device  is  off  line. 


Online  The  device  is  on  line  (or  marked  for  on  line) . 

Prv-Diag  (Used  with  the  OFFLINE  and  ONLINE  keywords.) 

The  device  is  marked  for  on  line  or  off  line, 
but  nothing  can  happen  until  the  respective 
controller  is  brought  on  line  or  taken  off 
line . 


Unknown  The  CSR  assignment  for  the  device  is  160000  and 

thus  cannot  be  accessed. 
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DIS  (Cont.) 


ALL 

Same  display  as  for  the  FULL  keyword  with  the  addition  of 
interrupt  vector  addresses  and  CSR  assignments  for  device 

controllers . 


ATTRIBUTES] 


Displays  interrupt  vector  addresses  and  CSR  assignments 
device  controllers. 


for 


The  DISPLAY  command  allows  more  than  one  keyword 
line.  However,  some  combinations  (such  as  DISPLAY 
DB)  are  meaningless.  The  DISPLAY  command 
inappropriate  keyword. 


per  command 
UNITS  FULL  FOR 
ignores  an 


If  the  command  omits  a  keyword,  the  display  contains 
names  and  status  flags  for  every  device  unit 
controller  in  the  current  configuration. 


the 

and 


logical 

device 


FOR  string 


An  optional  parameter  that  allows  a  selective  display  of  a 
particular  device  or  device  group.  When  you  use  this  parameter, 
CON  displays  the  requested  information  for  the  devices  specified 
in  the  string. 

You  can  also  use  one  or  two  wildcard  characters  (*)  the 

string.  You  use  one  wildcard  to  find  out  which  devices  are 
connected  to  the  controller  you  have  specified  after  the 
wildcard.  You  use  two  wildcards  to  find  out  which  devices  have 
the  attribute  you  have  specified  after  the  wildcards  (either 
ONLINE  or  OFFLINE). 

For  example : 

CON>  DIS  FULL  FOR  RH 

This  command  displays  all  of  the  RH  controllers . 

CON>  DIS  FULL  FOR  **ONL 


This  command  checks  to  see  which  devices  have  the  ONLINE 
attribute  (port-specific  status  is  not  displayed) . 


Examples 

CGN> DISPLAY  FULL  FOR  DB 

DBO!  Of f line? Multiport >Massbus»Accpath ? Dr i ver 

PORT  DBO A  RHBOJ  Online 

PORT  DBOB  RHCO ♦  Online »Current t Accpath 

DB1 :  Off  line » Multiport fMassbusfAccpath» Driver 

PORT  DB1 A  RHBi:  Online 

PORT  DB.1.B  RHCi:  Online»Current »  Accpath 


This  command  displays  information  about  all  of  the 
devices  configured  into  the  system. 


DB : -type 


15-10 


RSX-1 1M-PLUS  SYSTEM  RECONFIGURATION 


C  0  N  > 

DISPLAY  UNITS 

dbo: 

RHBOi fRHCO 

DEU  : 

RHBlt fRHCI 

DRO  J 

rhao: 

D  R 1  i 

RHA1 1 

MHO  t 

RHDOO J 

H  H 1 : 

coot 

RHDJ.  1  \ 

T  T  0  i 

YL  AO  t 

TT1 : 

yzao: 

T  T  2  ♦ 

Y  Z  A 1 J 

T  T  3  t 
uto  : 

YZA2J 

dko  : 

DKAO  t 

DKl  t 

DKA1  : 

DLO  : 

BL  AO : 

lpo: 

I..PA0  t 

l  pi  : 

lpbo: 

l  p  2 : 
nlo  : 

LPCOt 

DHO : 

dhao: 

Bhl  S 

DMA!  t 

This  command  displays  all  of  the  device  units 
configured  into  the  system. 


DIS  (Cont.) 


and  controllers 
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ESTAT 


ESTATUS 

The  ESTATUS  command  causes  CON  to  exit  with  its  exit  status  word 
reflecting  the  current  status  of  a  specified  device.  Used  with  the 
Indirect  Command  Processor  (Indirect;  see  the  RSX-11M/M-PLUS  Indirect 
Command  Processor  Manual) ,  the  command  returns  a  16-bit  word 
describing  device  status .  You  can  use  the  status  word  to  obtain 
information  about  the  configuration.  The  meanings  of  the  bits  in  the 
word  are  given  in  Table  15-2 .  Note  that  the  meanings  for  units  and 
controllers  are  different  from  those  for  ports. 


Table  15-2 

Exit  Status  Values  for  CON  ESTATUS 


If  the 

status  is  for  a  unit  or  controller: 

Bit 

No. 

Bit 

Value 

Description 

Display 

0 

1 

Exit  status  value: 

1 

2 

0  =  Warning 

2 

4 

1  =  Success 

6 

100 

2  =  Error 

4  =  Severe  error 

This  is  a  subcontroller  device. 

7 

200 

This  is  a  controller  device. 

8 

400 

0-device  is  on  line,  1-device  is 

Online 

9 

1000 

off  line. 

This  device  is  restricted  to  privileged 

Offline 

Prv  Diag 

10 

2000 

and  diagnostic  functions. 

This  is  a  multiport  device. 

Multiport 

11 

4000 

This  is  a  MASSBUS  device. 

Massbus 

12 

10000 

This  device's  CSR  is  160000 

Unknown 

13 

20000 

( unknown ) . 

This  device  has  an  on-line  access 

Accpath 

14 

40000 

path . 

This  device  has  context. 

Context 

15 

100000 

A  driver  is  loaded  for  this  device. 

Driver 

If  the 

request 

is  for  a  port: 

Bit 

No. 

Bit 

Value 

Description 

Display 

0 

1 

Exit  status  value  (see  above) 

1 

2 

2 

8 

4 

400 

0-port  on  line,  1-port  off  line. 

Online 

10 

2000 

This  is  the  current  port. 

Offline 

Current 

13 

20000 

There  is  an  on-line  access  path  to 

Accpath 

14 

40000 

this  port. 

This  port  or  the  device  it  services 

Context 

has  context. 
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ESTAT  (Cont.) 

Example 


>  @ti: 

AT  ♦  >  ♦  ENABL.E  SUBSTITUTION 
A T  ♦  >  CON  ESTAT  DB1  • 

> CON  ESTAT  DBlt 
AT  ♦  >  »  '  <  E  X  S  T  A  T  >  ' 

>  f 126401 
AT  4  >  "Z 
>0  <EOF> 


Invoke  Indirect* 

Enable  substitution  mode* 

Type  CON  command  line* 

System  displays  command  line* 

Reauest  contents  of  <EXSTAT>  to  be  displayed* 
System  displays  current  <EXSTAT>  contents* 
Exit  Indi rect 


Using  Indirect  interactively,  the  CON  command  line  emits  the 
current  status  of  DB1 : ,  which  is  stored  in  the  Indirect  special 
symbol  <EXSTAT> . 

The  number  126401  has  the  following  meaning: 

100000  Device's  driver  loaded. 

20000  Device  has  on-line  access  path. 

6000  Device  is  both  multiport  and  MASSBUS . 

400  Device  is  off  line. 

1  Exit  status  value  =  Success. 


15-13 


RSX— 11M-PLUS  SYSTEM  RECONFIGURATION 


HE 

HELP 

The  HELP  command  displays  the  help  text  for  CON. 
Format 

CON>HE[LP] 

Example 


CON>HFLP 

CON  --  Configuration  Control  Command  Task 
Implemented  commands? 

ONLINF  <device_l ist> 

ONLINE  MEMORY  Cmemora  .box> 

ONLINE  ALL 

OFFLINE  <dev.ice_l  ist> 

OFFLINF  MFMORY  <memor«..box> 

OFFLINE  ALL 

SET  <control.  1  er„.  sp 

(User  typed  CTRL/O  to  suppress  further  output.) 

This  example  shows  the  form  in  which  the  HELP  command 
information  about  the  system  configuration. 


displays 
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IDENT 


IDENT 

The  IDENT  command  displays  the  current  version  numbers  of  the  CON  and 
HRC  tasks.  The  date  and  time  the  tasks  were  task  built  are  also 
displayed . 

Format 

CON>IDENT 

Example 

CON  >1  DENT 


CON  —  CONFIGURF  Version  4*00 
Task  built:  l-OEC-85  12:52M3.5 

HRC  ~~  HRC  Version  004*000 
Task  built:  15~DEC~85  23:59:10*9 

In  this  example ,  Version  4.0  of  CONFIGURE  was  task  built  on 
December  1,  1985;  Version  4.0  of  HRC  was  task  built  on  December 

15,  1985. 
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LIN 


LINK 

The  LINK  command  logically  connects  a  port  of  a  switched  bus  run  to  a 
processor  and  thus  permits  access  to  the  devices  on  the  switched 
segment  of  the  bus  run . 

To  logically  connect  a  switched  bus  run  to  the  processor's  UNIBUS,  the 
devices  on  the  switched  segment  must  all  be  off  line  or  marked  for  on 
line.  You  cannot  dynamically  link  switched  bus  runs. 

Format 

CON > LINK  UBx  TO  CPx 


UBx 

The  target-switched  bus  run.  Switched  bus  runs  are  named  using 
the  designation  UB  followed  by  a  letter  from  the  DIGITAL  hardware 
alphabet  as  follows:  UBE,  UBF ,  UBH,  UBJ,  UBK,  UBL,  UBM,  UBN, 
UBP ,  UBR,  UBS,  and  UBT . 

CPx 


The  target  processor. 

Example 

CQN>  LINK  UBE  TO  CPA 

This  command  logically  connects  the  first  switched  bus  run  (UBE) 
to  processor  A  (CPA) . 
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LIST 


LIST 

The  LIST  command  displays  the  current  command  sequence  or  writes  the 
sequence  to  a  file.  You  can  use  this  command  to  keep  a  list  of  the 
commands  that  will  duplicate  the  current  configuration.  If  the  buffer 
in  which  the  current  command  sequence  is  stored  (see  the  description 
of  the  BUILD  command)  is  empty,  CON  returns  the  following  message; 

CON  —  Command  list  is  empty.  Nothing  to  print 

If  you  specify  a  .CMD  file  type,  you  can  execute  the  commands  from  the 
indirect  command  file  (that  is,  BUILD,  LIST  filename.CMD,  @filename) 
and  then  return  to  CON. 

Format 

CON>LIST  [filespec] 
filespec 

Any  legal  RSX-11M-PLUS  file  specification  in  the  form 
ddnn: [g,m] filename .type; version. 

Example 


C  0  N  > BUILD 
C G N > L I  ST 


ONLINE 

R  H  A 

ONL INF 

RHB 

ONLINE 

RHC 

OFF!.  INF 

UNA 

OFFLINE 

VIA 

ONLINE 

,Y  Z  A 

ON!..  INF 

D  K  A 

ONL  INF 

DLA 

ONLINE 

L  P  A 

ONLINE 

n  b  o : 

ONLINE 

dbi  : 

ONLINE 

dro  : 

ON!..  INF 

dri  : 

ONLINE 

mmo: 

ONLINE 

mi  t 

ONL.  INE 

coo: 

ONL I NE 

tto: 

ONLINE 

T  t  i : 

ONLINE 

r  T2 1 

ONLINE 

T  T  3  : 

ONLINE 

T  T  4  : 

ONL INF 

TT5 : 

ONLINE 

r  r  6 : 

ONLINE 

TT7  ♦ 

ONLINE 

mo: 

ONLINE 

DKO : 

ONLINE 

oki  : 

ONL INE 

D  L  o : 

ONLINE 

lpo: 

ONLINE 

nlo: 

ONI.  INE 

r»ho: 

ONLINE 

DMi : 
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LIST  (Cont.) 


In  this  example,  the  BUILD  command  creates  a  sequence  of  commands 
that  duplicates  the  current  system  configuration.  Next,  using 
the  LIST  command  displays  the  sequence  of  commands  you  would  use 
to  reestablish  the  current  system  configuration. 
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OFF 


OFFLINE 

The  OFFLINE  command  changes  the  state  of  a  inactive  device  to 
thus  removing  the  device  from  the  active  set  of  resources  in 
the  current  system  configuration.  This  prevents  further  device 
access.  To  take  a  device  off  line,  it  must  not  have  context  (see 
Section  15.1.3),  and  HRC  must  be  able,  in  1000 ( decimal )  tries  or  less, 
to  detect  when  there  is  no  I/O  activity  in  progress. 

The  transition  to  the  off-line  state  for  a  specific  device  controller 
is  completed  only  if  all  associated  devices  are  also  off  line.  If  an 
associated  device  is  not  off  line,  HRC  rejects  the  OFFLINE  command 
because  placing  the  device  off  line  could  interfere  with  active  I/O. 

Issue  the  appropriate  MCR  command(s)  to  remove  device  context.  This 
ensures  that  the  device  does  not  have  context  and  can  be  placed  off 
line . 

If  a  task  has  attached  the  device  unit,  the  task  must  be  detached  (or 
request  to  be  aborted)  before  the  unit  can  be  placed  off  line.  For 
example,  if  you  issue  an  OFFLINE  command  for  a  line  printer  controller 
(such  as  OFF  LPB) ,  and  a  connected  unit  (such  as  LP1 s )  has  context  (in 
this  case,  LP1 :  is  a  spooled  device  and  attached  by  the  Queue 
Manager),  CON  rejects  the  command  and  issues  the  following  error 
message : 


&  *  U  n  a  h  i  e  t  o  i  a  k  e  u  n  :i  t  w  i.  t  It  e  o  n  t  e  x  t  o  f  f  1  :i  n  e 

If  the  device  is  marked  for  on  line  (for  example,  a  device  unit  with 
its  controller  off  line),  the  command  changes  the  device  state  to 
off-line.  Subsequently,  when  the  controller  is  brought  on  line,  the 
system  does  not  activate  the  device . 

If  the  device  is  marked  for  off  line,  the  command  changes  the  device 
state  to  off-line  and  thus  enables  a  future  on-line  attempt. 


Individual  ports  of  dual-port  devices  can  be  taken  off  line 
separately.  You  may  want  to  do  this  if  the  port  does  not  work 
correctly  (for  example,  you  cannot  access  the  device  through  the 
port),  or  if  you  want  to  increase  system  throughput.  Figure  15-1  is 
an  example  of  the  way  throughput  could  be  increased: 


RHB 


DBOB 

DB°: 


DBOA 


RHA 


DB1 A 

“B'O 

ZK-575-81 

Figure  15-1  Sample  Configuration  for  Increasing  System  Throughput 
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OFF  (Cont.) 


With  this  configuration,  it  is  probable  that 
DBOA  port.  Because  activity  on  DB1:  must 
to  wait  until  DBOA  is  free.  If  you  put  only 
line,  each  DB  dish  has  its  own  controller 
for  another  port  to  be  free. 


the  system  will  use  the 
use  the  DB1A  port,  it  has 
ports  DBOB  and  DB1A  on 
and  does  not  have  to  wait 


The  OFFLINE  command  also  accepts  an  optional  keyword,  ALL,  which 
places  off  line  all  devices  except  the  system  disk  and  the  terminal 
that  issued  the  command.  (The  OFFLINE  ALL  command  is  useful  prior  to 
a  system  save.)  Before  issuing  the  OFFLINE  ALL  command,  you  must  first 
dismount  all  volumes  (tapes  and  disks)  except  the  system  disk  and  log 
out  all  terminals  except  the  issuing  terminal. 


Formats 

CON >OFF [LINE]  device- sped [ , device- spec2 . . . , device- specn] 

CON > OFF [LINE]  ALL 

Note  that  device-spec  also  includes  processors  (CPx) . 

Requirements 

•  Only  a  privileged  user  can  modify  the  system  configuration. 

•  No  tasks  are  attached  to  the  device. 

•  No  volumes  are  mounted  on  the  device. 

•  If  the  device  is  a  terminal,  no  users  are  logged  in  on  it. 


Example 

C  0  N  >  0  F  F  L  T  N  E  L  P  A  ?  I ..  P  0  l 

CGN>OFF  Y 7 A ?  Y 2 B  t  Y 7 C  ?  Y 7 D  !  Ter  minals  assumed  not  Tossed  in 

The  command  sequence  logically  places  the  devices  off  line,  which 
allows  the  bus  run  UBE  to  be  placed  off  line. 
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OFF  MEM 


OFFLINE  MEMORY 

(Multiprocessor  systems  only.)  The  OFFLINE  MEMORY  command  removes  a 
memory  box  from  the  system  configuration.  Because  memory  must  be 
contiguous,  the  target  box  must  be  the  memory  box  in  the  system 
configuration  with  the  highest  addresses  (the  last  memory  box  added  to 
the  system) .  If  the  target  box  is  not  the  last  box  in  the  memory 
configuration,  CON  rejects  the  command  and  issues  the  message: 


If  a  partition  maps  to  a  memory  box  targeted  for  off-line  status,  CON 
rejects  the  command  and  issues  the  following  message: 


Therefore,  you  must  contract  the  partition  structure  before  removing 
the  memory  box.  The  MCR  SET  /TOP  command  can  adjust  the  partition 
structure  up  or  down  (see  the  RSX-11M/M-PLUS  MCR  Operations  Manual  for 
details),  but  it  is  your  responsibility  to  ensure  that  nothing  is 
using  the  memory  in  the  memory  box.  The  system  is  protected  so  that 
you  cannot  bring  the  memory  box  off  line  if  anything  is  using  it. 


Format 


CON>OFF[LINE]  MEM[ORY]  memory-box 
Example 

CON>  OFF  MFH  HK2 t 

This  command  removes  memory  box  MK2 : 
configuration. 


from  the  system 
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ONL 


ONLINE 

The  ONLINE  command  changes  the  state  of  a  device  to  on  line  and 
enables  device  access. 


The  transition  to  the  on-line  state  is  completed  only  if  an  access 
path  exists  between  the  device  and  the  processor,  and  if  the  device 
driver  can  successfully  initialize  the  device. 

If  the  device  lacks  an  access  path,  the  ONLINE  command  changes  device 
state  to  marked  for  on-line;  the  device  is  activated  when  an  on-line 
access  path  becomes  available  (when  the  controller  is  brought  on 
line) . 


The  ONLINE  command  also  accepts  an  optional  keyword,  ALL,  which  places 
logically  on  line  every  device  controller  and  device  unit  known  to  the 

system. 


Note  that  the  data  base  values 
assignments  have  no  effect  on  the 
on  line. 


for  interrupt  vector  and  CSR 
system  until  the  device  is  brought 


Formats 

i 

CON > ONL [ INE ]  device-specl[ , device-spec2 . . . , device-specn] 


CON>ONL[INE]  ALL 


Requirements 

•  Only  a  privileged  user  can  modify  the  system  configuration. 

•  The  specified  device  must  be  physically  present  in  the  target 
system  and  included  in  the  system  at  system  generation. 

•  If  the  specified  device  is  serviced  by  a  loadable  driver,  the 
driver  and  device  data  base  must  be  loaded • 


The  ONLINE  command  activates  a  device  unit  only  if  the  associated 
controller  is  on  line.  The  command  first  tests  the  unit  to  determine 
whether  it  actually  exists  on  the  controller  and  then  performs  drive 
sizing  to  determine  device  unit  type.  If  the  unit  exists,  it  is  now 
ready  for  user  access.  If  the  associated  controller  is  off  line'  th<? 
command  marks  the  unit  for  on-line  status;  it  is  presence-tested  and 
sized  when  the  access  path  is  completed  and,  if  present,  activated. 


To  activate  a  device  controller,  the  ONLINE  command  tests  the 
controller’s  status  register  (CSR)  to  determine  whether  it  is 
physically  present.  If  the  controller  is  present,  then  all  of  the 
associated  units  that  are  marked  for  on-line  status  are 
presence- tested ,  sized,  and  brought  on  line.  Off-line  units  remain  in 
Se  relative  off-line  state  regardless  of  any  ONLINE  command  performed 
on  the  associated  controller. 


To  activate  a  processor  on  multiprocessor  systems,  the  ONLINE  command 
issues  a  bootstrap  request  to  the  target  processor.  If  the  target 
processor  ignores  the  bootstrap  request  or  cannot  boot  successfully, 
CON  issues  the  following  message  (after  a  time-out  of  5  seconds): 


*  %  C  c  Hi  IT:  3  n  d  e  >:  e  c  u  t  i  o  n  £  r  r  o  r  .  P  e  v  i  e  e  o  f  f  1  ‘  n  e 
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ONL  (Cont.) 


You  can  also  bring  on  line  individually  the  ports  of  a  dual-port 
device,  thus  increasing  system  throughput  because  you  do  not  have  to 
wait  for  both  ports  if  one  does  not  work. 

For  dual-port  terminals,  you  need  a  Status  Control  Block  (SCB)  for 
each  terminal  to  bring  the  ports  of  dual-port  terminals  on  line 

individually  and  to  switch  them  individually.  To  switch  the  ports, 

the  software  will  bring  the  controller  on  line,  but  the  terminals  must 
be  switched  manually  using  the  CS11  switch  on  each  terminal.  If  you 

have  only  one  SCB  for  each  controller,  all  of  the  terminals  on  a 

controller  have  to  be  switched  over  to  the  same  controller. 

Examples 

The  following  command  sequence  (used  on  a  multiprocessor  system) 
assumes  that  the  UBE  bus  run  has  been  switched  from  CPA  to  CPB . 
The  commands  place  the  software  bus  devices  on  line  for  access : 

C0N> ONLINE  LPArLPO*  !  On  line  line  printer  and  controller 

CON>QNL.  YZA * YZB * YZC * YZD  !  On  line  terminal  interfaces 

CON > ONL  TT2tfTT3*fTT4*fTT5t  !  On  line  terminals  , 

C 0 N >  ONL  TT6 ♦ ?  TT7 ♦ ?  TT10 ♦ >TT1 1 J 

The  following  command  places  all  devices  on  the  system  logically 
on  line: 

CON>  ONL  ALL 

This  command  places  on  line  every  device  controller  and  device 
unit  (except  CPUs)  known  to  the  system  (that  is,  all  controllers 
and  devices  included  at  system  generation) .  If  a  device  unit  or 
device  controller  lacks  an  access  path,  the  command  marks  these 
for  on-line  status. 

Note  that  placing  all  devices  on  line  takes  several  seconds  on  a 
large  system  and  that  the  command  does  not  generate  any  error 
messages  saying  that  a  device  may  not  be  on  line. 
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ONL  MEM 


ONLINE  MEMORY 

(Multiprocessor  systems  only. )  The  ONLINE  MEMORY  command  adds  a  memory 
box  to  the  system  configuration.  To  place  the  additional  memory  on 
line,  you  must  first  place  the  appropriate  memory  box  port  controllers 
and  the  memory  box  itself  logically  on  line.  The  box  you  specify  will 
have  the  highest  memory  addresses . 

To  use  the  additional  memory,  you  must  expand  the  partition  structure 
with  the  MCR  SET  /TOP  command  (see  the  RSX- 1 1 M/ M- PLU S  MCR  Operations 
Manual) . 


Format 


CON>ONLINE  MEMORY  memory-box 


Example 


C  0  N  >  0  N 1.  I N  F  «  F  M  0  R  Y  KK  2  t 


This  command  adds  the  memory  box  MK2 :  to  the  system 

configuration . 
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SET 


SET 

The  SET  command  changes  the  value  of  the  CSR  or  the  interrupt  vector 
address  for  an  off-line  device.  The  values  are  stored  in  the  device 
driver's  data  base. 

SET  cannot  verify  the  CSR  or  interrupt  vector  address  that  you 
specify.  If  you  specify  an  incorrect  CSR  address,  the  system  will  not 
be  able  to  access  the  device  when  you  issue  the  ONLINE  command  for  the 
device.  If  you  specify  an  incorrect  interrupt  vector  address,  the 
system  will  send  interrupts  to  nonexistent  interrupt  vectors  when  you 
place  the  device  logically  on  line;  the  device  cannot  be  accessed. 
Also,  if  you  specify  an  interrupt  vector  that  is  in  use,  you  will  get 
an  error  when  you  attempt  to  place  the  controller  on  line.  (See  the 
RSX-11M-PLUS  Guide  to  Writing  an  I/O  Driver  for  descriptions  of  the 
CSR  and  vector  assignment  errors .1 

On  multiprocessor  systems,  the  SET  command  also  activates  the  sanity 
timer  and  enables  an  alarm  if  the  timer  expires. 

Format 

CON > SET  controller  option=value 

controller 

The  device  controller  (for  example,  RHA  or  DMA), 
option 


;  of  the 

following : 

CSR 

Alters  the  value  of  the  controller's 
stored  in  the  driver  data  base. 

CSR 

address 

VEC 

Alters  the  value  of  the  controller's  interrupt  vector 
address  stored  in  the  driver  data  base. 

TIMER 

( Multiprocessor 
the  sanity  timer 

systems  only. )  Activates 
(controller  is  RHx). 

or 

inhibits 

ALARM 

( Multiprocessor 

systems  only. )  Activates 

or 

inhibits 

an  alarm  upon  sanity  timer  timeout  (controller  is 
RHx )  . 


value 

If  the  SET  option  is  CSR,  the  value  must  be  between  160000 ( octal ) 
and  177777 (octal ) .  Note  that  if  you  specify  a  CSR  address  of 
160000  pr  less,  the  device  is  "unknown"  and  cannot  be  placed  on 
line.  /  This  allows  you  to  use  the  CON  ONLINE  ALL  command  without 
bringing  every  device  on  line  when  the  current  hardware 
configuration  differs  from  the  generated  system.  For  example,  if 
the  target  system  has  a  DMC11  with  a  CSR  address  of  160100,  but 
the  generated  system  has  a  DZ11  at  that  address,  CON  ONL  ALL 
attempts  to  bring  the  DMC11  on  line  as  a  DZ11 .  Note  that  the 
attempt  may  crash  the  system. 

If  the  SET  option  is  VEC,  the  value  must  be  less  than  774(octal). 
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SET  (Cont.) 


On  multiprocessor  systems,  if  the  SET  option  is  TIMER  or  ALARM, 
the  value  is  either  ON  (to  activate)  or  OFF  (to  inhibit). 

Requirement 

The  device  must  be  off  line  and  the  driver  must  be  loaded. 
Examples 

C0N>  SET  L.PA  ME (>1.60 

This  command  changes  the  interrupt  vector  address  for  the  first 
line  printer  controller  to  160(octal). 

CQN> 8FT  LPA  C 8 ft  - 177600 

This  command  changes  the  CSR  address  for  the  first  line  printer 
controller  to  177600 (octal ) . 
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SWI 


SWITCH 


(Multiprocessor  systems  only.)  The  SWITCH  command  logically  inverts 
the  processor  association  of  a  switched  bus  run;  that  is,  it  performs 
an  unlink  operation  followed  by  a  link  operation.  The  command  uses  a 
special  hardware  feature  of  the  DT07  to  guarantee  that  the  switched 
bus  is  linked  to  the  target  processor  after  the  unlink  operation. 
Thus,  the  SWITCH  command  ensures  that  the  switched  bus  will  be 
logically  connected  to  the  desired  processor. 

For  example,  in  a  three-processor  system,  a  properly  configured 
switched  bus  can  be  connected  to  any  one  of  three  processors .  An 
UNLINK  command  permits  any  processor  to  then  link  the  switched  bus. 
However,  the  SWITCH  command  specifies  that  only  a  specific  processor 
can  link  the  switched  bus  run  following  the  unlink  operation.  If  CPA 
and  CPB  are  running  as  a  dual-processor  system  and  CPC  is  a 
single-processor  system,  a  switch  from  CPA  to  CPB  occurs  even  if  CPC 
is  trying  to  gain  control  of  the  bus . 

CON  rejects  the  command  if  a  device  attached  to  the  switched  bus  has 
context  (that  is,  the  device  is  processing  or  allowing  processing  of 
I/O)  . 

Format 

CON> SWITCH  UBx  TO  CPx 


UBx 

The  target-switched  bus  run.  Switched  bus  runs  are  named  using 
the  designation  UB  followed  by  a  letter  from  the  DIGITAL  hardware 
alphabet  as  follows:  UBE,  UBF ,  UBH ,  UBJ,  UBK,  UBL,  UBM,  UBN, 
UBP ,  UBR,  UBS,  and  UBT . 

CPx 

The  target  processor. 

Example 

C0N>QFF  LPAfLPO J 
C0N>0FF  YZAfYZBf YZCf YZD 
C0N>0FF  TT2  ♦  >TT3! f  TT4  ♦  f  TT5  J 
C0N>0FF  TT6 : f  TT7 1 , TT 1 0  J  f  TT 1 1 : 

CON>SUITCH  UBE  TO  CPB 
C0N>QNL  LPAfLPOJ 
C0N>0NL  YZAfYZBfYZCfYZD 
C0N>QNL  TT2t fTT3t fTT4: fTT5J f 
CON >0 N L  TT6J  fTT7: fTTIO: fTTU  J 


Off  line  printer  and  controller 
Off  line  terminal  interfaces 
Off  line  all  terminals 

Terminals  assumed  not  loSsled  in 
On  line  line  printer  and  controller 
On  line  terminal  interfaces 
On  line  terminals 
(Devices  now  connected  to  CPB) 


This  command  sequence  logically  disconnects  the  first  switched 
bus  run  (UBE)  from  its  respective  processor  and  then  logically 
connects  UBE  to  processor  B. 
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UNL 


UNLINK 

The  UNLINK  command  disconnects  a  port  of  a  switched  bus  run  from  its 
respective  processor.  This  command  reverses  the  effect  of  the  LINK 
command • 

CON  rejects  the  command  if  any  device  attached  to  the  switched  bus  has 
context  (that  is,  the  device  is  processing  or  allowing  processing  of 
I/O)  . 

Format 

CON > UNL INK  UBx 


UBx 

The  switched  bus . 

Example 

CON > ^ N L  IJBE  i  Terminals  assumed  not  lossied  in 

This  command  disconnects  the  switched  bus  port  of  UBE  from  its 
respective  processor. 
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15.5  SYSTEM  FAULTS 

System  faults  cause  an  RSX-11M-PLUS  system  to  stop  processing  an 
application  properly.  A  fault  could  be  a  user  error,  a  system 
software  failure,  an  application  software  error,  or  a  hardware  fault. 
User  errors  (for  example,  accidentally  removing  a  disk  from  the 
system)  are  obvious  because  the  fault  usually  occurs  immediately  after 
the  user  action.  System  software  failures  usually  occur  when  a  system 
bug  is  encountered  while  you  are  debugging  the  application  software. 
Application  software  errors  are  application-specific  and  not  discussed 
in  this  manual.  Hardware  faults  —  their  detection,  isolation,  and 
recovery  from  —  are  discussed  in  the  remainder  of  this  chapter. 


15.5.1  Hardware  Faults 

Hardware  faults  can  be  placed  in  the  following  categories: 

•  Media  failures 

•  Transient  failures 

•  Intermittent  failures 

•  Soft  errors 

•  Hard  errors 

The  following  sections  describe  each  of  these  types  of  faults. 


15.5.1.1  Media  Failures  -  Media  failures  occur  when  I/O  operations 
fail  because  portions  of  the  medium  (a  disk  or  tape)  are  bad.  For 
both  disks  and  tapes,  when  a  media  failure  is  detected,  read 
operations  are  retried. 

Before  disks  are  initialized,  you  should  check  them  for  faulty  sectors 
with  the  BAD  utility.  BAD  marks  the  bad  sectors,  which  prevents  the 
file  system  from  using  them.  (See  the  RSX-1 1M/M-PLUS  Utilities  Manual 
for  more  information.) 

Occasionally,  sectors  on  the  media  become  bad,  causing  I/O  operations 
to  those  sectors  tc  fail.  The  error  logging  system  can  be  used  to 
detect  these  failures.  (See  the  RSX-1 1M/M-PLUS  Error  Logging  Manual 
for  more  information.)  You  should  probably  replace  faulty  media  if 
they  have  critical  data  recorded  on  them  or  if  a  large  number  of 
errors  occur  on  them. 

On  devices  supported  by  DUDRV,  bad  blocks  may  be  replaced  by  the  Bad 
Block  Replacement  Control  Task  (RCT) .  See  Chapter  5  for  more 
information  on  this  process. 


15.5.1.2  Transient  Failures  -  Transient  failures  cannot  be  repeated 
and  are  caused  by  electrical  factors  such  as  static  from  clothing  or 
carpeting.  If  the  failure  occurs  on  an  I/O  device,  the  I/O  operation 
is  retried  automatically  and  the  application  software  never  sees  the 
failure.  (The  Error  Logger  records  the  failure,  however.)  If  the 
failure  occurs  in  memory  or  in  a  central  processor,  the  system  may 
crash  and  have  to  be  rebooted . 
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15.5.1.3  Intermittent  Failures  -  Intermittent  failures  are  caused  by 
irregular  conditions  within  the  system  and  usually  happen  during 
periods  of  high  system  or  device  activity.  The  failures  usually  occur 
where  recorded  data  is  corrupted  enough  so  that  it  cannot  be  read. 
The  data  becomes  corrupted  when  the  device  on  which  it  is  recorded  is 
not  working  properly,  usually  because  of  a  temporary  power  shortage. 

An  example  of  an  intermittent  failure  is  a  disk  device  detecting  a 
power  failure,  which  causes  the  disk's  volume  valid  bit  to  be  reset. 
Dismounting  and  remounting  the  disk  clears  this  condition  and  may 
allow  I/O  operations  to  proceed. 

If  the  sources  of  intermittent  failures  are  not  obvious  or  directly 
reproducible,  try  to  recreate  the  conditions  that  caused  the  failure 
by  using  the  I/O  Exerciser  (IOX).  IOX  simulates  high  system  activity, 
which  could  cause  the  failure  to  recur.  (See  Chapter  4  for 
information  on  IOX) . 

Intermittent  failures  that  result  in  device  errors  appear  in  the  error 
log. 


15.5.1.4  Soft  Errors  -  Soft  errors  are  device  errors  that  do  not 
prevent  an  I/O  operation  from  completing  successfully.  The  device 
driver  retries  the  operation  and,  depending  on  the  capabilities  of  the 
device,  performs  ECC  correction  or  disk-head  offset  positioning. 

Soft  errors  usually  indicate  poor  media  or  a  misaligned  device.  For 
example,  disk  heads  that  are  not  aligned  properly  cause  disk  errors. 
These  errors  can  be  corrected  by  head  offset  positioning. 

If  several  soft  errors  occur  on  a  device,  you  should  find  the  source 
of  the  errors  and  correct  it  through  field  service  maintenance. 

Soft  errors  are  recorded  by  the  Error  Logger. 


15.5.1.5  Hard  Errors  -  Hard  errors  are  solid  device  failures  that 
prevent  a  device  from  working  properly.  The  errors  make  the  device 
unusable,  but  they  are  also  the  easiest  to  diagnose  and  correct. 

The  Error  Logger  records  failed  operations  on  the  disks  and  tapes,  but 
that  information  is  usually  unnecessary  since  the  failures  are 
obvious . 

You  can  also  use  IOX  to  test  the  capabilities  of  many  peripheral 
devices  to  determine  if  they  are  failing. 


15.5.2  Recoverable  and  Nonrecoverable  Errors 

Soft  errors  and  many  media  errors  are  recoverable  errors .  They  are 
recorded  by  the  Error  Logger  but  do  not  impact  system  operation. 

Hard  errors  and  some  media  errors  are  nonrecoverable  errors .  They 
usually  result  in  recurring  device  errors  and  failure  of  the 
application  software.  (The  application  can  survive  one  failure  on 
each  device  type  before  it  will  stop  processing  completely.)  However, 
the  operating  system  itself  often  survives  the  failure  because  all  it 
requires  to  continue  running  is  the  system  disk,  the  central 
processor (s) ,  and  memory. 
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15.6  FAULT  I SOLATION 

Once  the  software  is  stable ,  the  availability  of  a  system  depends  on 
the  reliability  of  individual  devices  and  the  time  required  to  restore 
processing.  RSX-11M-PLUS  systems  can,  in  some  cases,  work  around 
equipment  failures  in  individual  devices;  but  you  must  eventually 
isolate  a  faulty  device,  correct  the  reason  for  the  failure,  and 
restore  it  to  the  system.  Depending  on  the  severity  and  location  of 
the  error,  you  may  have  to  restart  the  application  and/or  the  system. 

Failures  often  exhibit  symptoms  that  allow  you  to  detect  a  failing 
device  before  it  can  disrupt  system  operation.  Because  of  this,  you 
should  regularly  monitor  the  condition  of  all  RSX-1 1M-PLUS  peripherals 
and  their  ability  to  respond  correctly  to  I/O  requests,  by 
periodically  examining  the  error  log  reports  on  all  devices  and 
occasionally  running  IOX  on  infrequently  used  devices .  The  Error 
Logger  gathers  information  concerning  all  types  of  errors  as  they 
occur  and  generates  comprehensive  error  reports.  IOX  tests  the 
validity  of  mass  storage  devices.  The  tests  exercise  combinations  of 
devices  under  high  I/O  activity. 

Both  the  Error  Logger  and  IOX  provide  error  reports  that  contain  a 
description  of  device  fault  conditions .  Use  the  reports  to  determine 
whether  the  device  should  remain  in  operation.  If  the  fault 
conditions  are  transient  (see  Section  15.5.1.2)  and  the  device  is 
capable  of  correctly  performing  its  I/O  functions,  the  device  can 
remain  in  operation.  However,  you  should  closely  monitor  the  device 
and  schedule  it  for  future  maintenance  as  required. 


15.7  SYSTEM  RECOVERY 

The  procedure  you  use  to  diagnose  and  recover  from  a  system  fault 
depends  on  the  primary  use  of  your  system.  If  it  is  mainly  used  for 
application  development,  then  you  would  want  to  use  the  Error  Logger 
or  IOX  to  determine  the  cause  of  a  failure  to  prevent  future  failures. 
If  your  system  is  used  for  process  control  and  is  running  an 
application  that  requires  enhanced  availability,  utilities  such  as  the 
Executive  Debugging  Tool  (XDT )  are  necessary  only  as  much  as  they  can 
be  used  to  isolate  and  correct  failed  components.  Your  main  objective 
is  to  bring  the  system  back  up  and  restart  the  application,  with  only 
limited  diagnostics  for  future  references. 

To  restart  the  system  and  the  application,  first  bring  up  the  minimum 
system  required  for  running  RSX-11M-PLUS .  Then,  gradually  bring 
devices  on  line  until  you  have  the  minimum  system  required  for  running 
the  application.  If  any  of  the  devices  are  faulty,  you  can  take  them 
back  out  of  the  system  and  bring  others  on  line  until  you  have  the 
required  configuration. 

The  method  for  recovering  from  system  faults  also  depends  on  the  type 
of  fault.  For  example: 

•  Transient  errors  could  cause  the  system  to  crash,  which  would 
require  rebootstrapping . 

•  Hard  errors  require  the  device  not  to  be  used  and  possibly  to 
be  reconfigured  out  of  the  system  so  that  diagnostics  for  it 
can  be  run . 

•  Intermittent  errors,  because  their  source  is  not  so  obvious, 
could  require  you  to  begin  with  a  minimum  configuration  and 
then  gradually  add  devices  until  you  find  the  one  that  caused 
the  error. 
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If  the  minimum  configuration  has  the  problem,  you  will  have  to  switch 
to  another  one.  Another  possible  way  to  recover  from  intermittent 
failures  is  to  turn  the  error  into  a  hard  error  by  imposing  an 
appropriate  system  load  using  IOX.  By  recreating  the  error,  you  can 
discover  its  source  and,  therefore,  how  to  correct  it. 

The  following  sections  describe  how  to  recover  from  different  kinds  of 
hardware  failures . 


15.7.1  Device  Unit  and  Controller  Failures 

Most  failures  in  an  operating  system  result  from  disk,  tape,  or  other 
such  device  failures:  either  the  units  themselves  fail  or  the 

respective  controller  fails. 

The  time  needed  to  reconfigure  around  these  failures  depends  entirely 
on  the  application.  If  the  application  can  notify  an  operator  of  the 
failure,  thus  allowing  the  operator  to  remove  and  inspect  the  media, 
mount  it  on  another  drive,  and  reintegrate  it  into  the  system,  then 
the  time  to  reconfigure  is  short.  If,  on  the  other  hand,  the  operator 
must  find  a  way  to  halt  the  application,  move  the  media,  and  restart, 
then  the  time  to  reconfigure  increases. 

On  RSX-1 1M-PLUS  systems,  TKTN  prints  a  message  at  the  console  terminal 
whenever  an  unrecoverable  hardware  error  occurs.  For  example: 

&  %  %  D  B 1  *  -  -  U  n  r  e  c  a  v  e  r  a  h  1  e  h  a  r  d  w  a  r  e  H  a  v  :i.  c  e  e  r  r  o  r 

These  messages  can  alert  an  operator  to  an  impending  failure  and  allow 
time  to  issue  the  commands  to  remove  the  failing  unit  from  the  system. 


15.7.2  Processor  Failures 

Although  it  occurs  rarely  in  comparison  with  device  unit  and 
controller  failures,  a  processor  failure  also  halts  system  operation. 

Note  that,  on  multiprocessor  systems,  a  crash  or  trap  or  other  failure 
may  occur  on  a  processor  other  than  the  faulty  one. 

If  a  processor  fails,  the  system  usually  exhibits  one  of  the  following 
symptoms : 

•  The  system  traps  to  XDT  or  crashes . 

•  The  sanity  timer  expires  for  one  or  more  processors 

(multiprocessor  systems  only) . 

•  The  console  lights  on  nonremote  diagnostic  consoles  show  that 
the  system  is  halted  in  the  Executive. 

•  The  system  halts  with  no  printouts  or  visual  indicators . 

On  multiprocessor  systems,  regardless  of  the  cause  of  a  processor 
failure,  the  recovery  technique  is  straightforward  and  direct:  you 
must  isolate  and  exclude  the  disabled  processor  and  reboot  the  system. 
The  memory  configuration  need  not  change  unless  you  wish  to  perform 
stand-alone  diagnostics  (see  Section  15.8)  on  the  failed  processor. 


15-32 


RSX-1 1M-PLUS  SYSTEM  RECONFIGURATION 


15.7.3  MK11  Memory  Box  Failures 

The  two  most  common  causes  of  memory  failures  are  uncorrectable 
double-bit  errors  (parity  errors)  and  loss  of  memory  power. 

If  a  user-state  task  encounters  an  uncorrectable  memory  parity  error, 
the  system  aborts  the  task  and  locks  that  portion  of  memory.  The 
Fixer  task  (FXR)  detects  the  parity  errors  and  creates  a  distinct 
segment  in  the  task's  region  using  the  memory  in  which  the  errors  were 
detected.  This  segment  is  separate  from  the  rest  of  the  region  and  is 
not  used  by  other  tasks.  FXR  is  completely  transparent  to  both  users 
and  tasks . 

If  the  Executive  or  a  system-state  task  encounters  an  uncorrectable 
parity  error,  the  system  prints  the  following  message  and  then  halts: 

***EX EC  PARITY  ERROR  STOP 

Also,  the  sanity  timers  on  multiprocessing  systems  may  expire. 

Regardless  of  system  state  (user  or  kernel),  a  double-bit  error  causes 
the  memory  box  hardware  to  light  the  UNCOR  ERROR  light (s)  on  the 
respective  memory  box  port  controllers. 

When  an  uncorrectable  error  halts  the  system,  you  must  manually 
exclude  that  memory  box  and  rebootstrap,  as  follows: 

1.  Switch  all  ports  of  the  faulty  box  off  line.  If  necessary, 
use  the  thumbwheel  switches  to  properly  address  the  remaining 
memory  box(es) .  (The  thumbwheel  switches  are  used  when  the 
failed  box  is  box  0,  which  is  the  boot  box,  or  when  you  want 
to  disable  a  memory  box  by  changing  the  starting  addresses  of 
the  remaining  boxes . ) 

2.  Halt  the  processor,  initialize  it,  and  febootstrap  the 
system. 

When  loss  of  power  causes  the  memory  failure,  the  system  halts.  The 
system  exhibits  one  or  more  of  the  following  symptoms: 

•  No  lights  or  indicators  are  lit.  This  usually  indicates  that 
the  outside  power  supply  has  failed. 

•  No  MEM  POWER  READY  lights  are  lit  on  the  memory  box.  This 

indicates  that  the  memory  box's  power  supply  has  failed  or  has 

been  powered  down.  Check  the  power  switch  on  the  Port  A 

controller  to  the  box. 

•  No  MEM  POWER  READY  lights  are  lit  on  one  port  of  all  memory 

boxes.  This  indicates  that  the  CPU's  power  supply  has  failed 
or  that  the  CPU  has  been  powered  down.  Note  that  the  power 
supply  failure  could  have  come  through  an  expander  box  or 
through  the  far  side  of  a  switched  bus  currently  switched  to 
the  CPU . 

In  all  of  the  above  cases,  if  a  CPU  or  a  memory  box  has  been  switched 
off  but  then  switched  back  on  before  the  memory  batteries  discharge, 
the  system  usually  recovers  without  rebootstrapping.  Otherwise, 
follow  the  same  two  steps  used  when  an  uncorrectable  error  halts  the 
system. 
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15.8  STAND-ALONE  MAINTENANCE  FOR  MULTIPROCESSOR  SYSTEMS 

On  multiprocessing  systems,  when  a  device  fails,  it  is  often  necessary 
to  run  diagnostic  tasks  before  servicing  the  device.  However,  the 
diagnostic  tasks  require  a  processor  for  execution.  Thus,  to  service 
most  devices,  you  must  remove  a  processor  from  the  system. 

The  following  list  gives  the  requirements  for  testing  and  servicing 
peripheral  devices : 

1.  A  processor  must  be  available  to  execute  the  diagnostics  for 
the  peripheral. 

2.  Memory  must  be  available  for  the  diagnostics. 

3.  A  mechanism  to  load  the  diagnostic  task  into  memory  must  be 
available . 

The  processor  that  executes  the  diagnostics  must  be  connected  to  the 
UNIBUS  on  which  the  device  to  be  tested  resides.  This  implies  that 
other  peripherals  on  that  bus  run  will  not  be  available  to  the 
remainder  of  the  system.  Therefore,  when  determining  the  initial 
system  configuration,  you  must  ensure  that  duplicate  devices  are 
located  on  distinct  bus  runs.  If  the  device  to  be  tested  is  on  a 
switched  bus  run,  the  switched  bus  can  be  connected  to  any  processor 
to  which  it  has  access. 

To  make  memory  available  for  diagnostic  tasks,  the  usual  procedure  is 
to  logically  remove  a  memory  box  from  the  running  system  and  use  the 
box  for  diagnostics  only.  This  memory  box  is  then  switched  manually 
so  that  the  processor  to  be  used  for  diagnostics  views  the  box  with  a 
starting  address  of  0. 

For  loading  a  diagnostic  into  memory,  the  RSX-11M-PLUS  multiprocessor 
system  provides  the  Diagnostic  Loader  task  ( DLD ) .  DLD  loads  a 
diagnostic  program  into  a  partition  in  the  memory  box  of  the 
diagnostic  processor  (the  processor  to  which  the  failed  device  is 
attached).  Diagnostic  programs  are  system  image  files  that  you  use  to 
test  the  failed  devices.  The  partition  is  created  and  specified  by 
you  and  is  mapped  by  Program  Logical  Address  Space  (PLAS)  directives. 
By  default,  DLD  clears  the  partition  to  the  end  after  loading  the 
program.  The  diagnostic  is  then  run  stand  alone. 

The  steps  for  using  DLD  are  as  follows: 

1.  Use  FLX  to  transfer  the  diagnostic  program  from  the 

diagnostic  tape  or  disk  to  a  Files-11  device  attached  to  the 
diagnostic  processor.  (See  the  RSX-11M/M-PLUS  Utilities 
Manual  for  information  on  FLX.)  Because  the  tape  or  disk  is 
in  DOS-11  format,  use  the  FLX  Image  Mode  switch  (/IM)  to 
convert  the  file  (the  diagnostic  program)  to  Files-11  format. 
The  file  is  in  formatted  binary  format  and  has  a  file  type  of 
.BIC  or  .BIN.  (Note  that  binary  formatted  files  are  not 

patchable . ) 

2 .  Reconfigure  your  system  so  that  you  have  a  system  with  two 
CPUs  and  two  memory  boxes  (each  box  has  256K  words  of 
memory).  The  configuration  would  be  as  follows: 


BOX  0 

PORT 

A 

ONLINE,  START=000 

PORT 

B 

OFFLINE 

BOX  1 

PORT 

A 

OFFLINE 

PORT 

B 

ONLINE,  START=000 

1 1  ST 

Off 

line  both  sides. 
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3.  Bootstrap  RSX-11M-PLUS  on  CPA. 

4.  Set  BOX  0  PORT  A  to  ONLINE ,  START=010 

5.  Bring  Box  1  on  line.  This  memory  box  will  contain  the 
diagnostic  partition.  For  example: 

CGN>  ONL  MKE  >  MK2  t 

6.  Use  the  CON  DISPLAY  command  to  find  out  the  base  address  and 
size  of  the  memory  box.  For  example: 

C0N>  DISP  FULL  ATT  FOR  MK2 ♦ 

The  base  address  of  the  partition  will  be  the  base  address  of 
the  diagnostic  program. 

7.  Create  the  diagnostic  partition  in  the  memory  box  by  using 

the  command  SET  /PAR  and  specifying  type  DIAG.  This 

partition  will  be  devoted  to  diagnostic  functions  and  should 
begin  at  the  location  in  memory  that  the  diagnostic  processor 
will  see  as  location  0  or  the  bottom  of  memory.  For  example: 

> SET  /PAR=JIHKJ20000: 1777JDIAG 

This  command  creates  a  partition  named  JIMK  with  a  base 
address  of  2000000  and  consisting  of  1777 ( decimal )  32-word 
blocks.  The  other  processors  see  the  memory  box  used  for 
diagnostics  as  starting  at  location  2000000,  but  the 
processor  running  the  diagnostic  will  see  the  box  as  starting 
at  location  0. 

Other  partition  types  used  with  the  SET  /PAR  command  ensure 
that  the  requested  memory  is  within  the  system  image  area 
(less  than  $SYSIZ),  but  DIAG  ensures  only  that  the  memory 
physically  exists.  For  the  other  processor  to  run 
concurrently  with  the  diagnostic  processor,  the  partition 
must  be  larger  than  $SYSIZ. 

8.  Use  DLD  to  convert  the  binary  formatted  file  into  a  bootable 
system  image  file  (patchable  with  ZAP;  see  the  RSX-11M/M-PLUS 
Utilites  Manual )  and  then  to  load  it  into  the  partition.  The 
DLD  command  line  has  the  following  format: 

Format 

DLD > [partition] [ /HE ]=filename[ . typ] [ /qualifier] 
partition 

The  partition  created  in  the  diagnostic  processor's 
memory  box  into  which  the  diagnostic  program  will  be 
loaded.  You  must  specify  a  partition  name  if  you  do  not 
use  the  /NL  switch  (see  below) .  DLD  produces  a 
"partition  not  found"  error  message  otherwise.  If  you 
specify  both  a  partition  name  and  the  /NL  switch,  the 
switch  overrides  the  name. 

/HE 

Provides  a  brief  description  of  DLD ' s  use  and  format. 

typ 

The  file  type  for  the  diagnostic  program.  The  file  type 
can  be  .BIC,  .BIN,  or  .SYS. 
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If  the  file  type  is  .BIC  or  .BIN,  DLD  converts  the  file 
into  a  system  image  file.  If  you  specify  either  file 
type,  but  DLD  cannot  find  the  file,  it  searches  for  the 
other  file  type  before  giving  up.  If  you  do  not  specify 
any  file  type,  DLD  first  looks  for  a  file  with  the  .BIC 
file  type  and  then  for  one  with  the  .BIN  file  type. 

If  the  file  type  is  .SYS,  DLD  does  not  have  to  convert 
the  file;  it  is  ready  to  be  loaded  into  the  memory  box. 

/qualifier 

One  of  the  following: 

/NL  Inhibits  loading  of  the  diagnostic  program 

(DLD  only  creates  the  system  image  file) . 

/NC  Inhibits  clearing  (zeroing)  of  any  remaining 

memory  in  the  partition  after  the  diagnostic 
program  has  been  loaded.  The  default  is  to 
clear  the  remaining  memory. 

/OFF : n  Offsets  the  starting  location  of  the  load  by 

n  times  32 (decimal)  words.  The  area  between 
the  beginning  of  the  partition  and  the 
beginning  of  the  diagnostic  is  untouched. 

/LI  Lists  information  about  the  partition  and 

the  file:  the  partition  name  (if  you  have 

specified  one),  the  base  and  size  of  the 
partition,  and  the  new  name  of  the  system 
image  file  (if  converted). 

Specifying  this  switch  gives  you  the 
transfer  address  (usually  200  or  1000)  of 
the  diagnostic  program.  The  transfer 
address  is  needed  to  initiate  the 
diagnostic . 

/LW  Accounts  for  the  DOS-11  link  word  that  may 

exist  in  bytes  0  and  1  of  every  input  block. 

Example 


JIhK=TEST* BIN/LI 


This  command  sequence  converts  the  binary  formatted  diagnostic 
file  TEST .BIN  into  the  system  image  file  TEST. SYS.  DLD  also  lists 
the  transfer  address  of  the  file  and  other  information  about  the 
file  and  the  partition. 


9. 


DLD  loads  the  program  into  a  region  that  it  creates  in  the 
diagnostic  partition.  The  region  is  called  DIAG  and  is  the  same 
size  as  the  partition.  After  the  program  is  loaded,  DLD  clears 
any  remaining  memory  from  the  partition  (unless  otherwise 
specified) . 


10.  To  run  the  diagnostic  program,  halt  the  processor  (in  this  case, 
CPB ) ,  toggle  in  the  transfer  address  of  the  program  (from  using 
the  /LI  switch),  and  then  push  the  START  button  to  begin  the 
diagnostics . 
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11 .  Use  the  following  MCR  command  line  to  remove  the  diagnostic 
partition  from  the  memory  box: 

>  REMOVE  0 TAG/REG 


15.9  ERROR  MESSAGES 

The  CON  and  HRC  error  messages  consist  of  one  or  more  lines  of 
information  in  the  following  format: 

CON  —  error  message 
(detail  of  error  message) 

The  first  line  is  the  general  error  message.  The  second  and  any 
succeeding  lines  define  the  error  message. 

In  addition  to  the  description,  the  error  messages  may  include 
Directive  Status  Word  error  codes  and  I/O  error  codes.  For 
explanations  of  these  codes,  refer  to  the  RSX- 1 1 M/M- PLU S  and  and 
Micro/RSX  I/O  Operations  Reference  Manual . 

A  list  of  the  CON  and  HRC  error  messages  and  a  brief  explanation  of 
each  follows. 


15.9.1  CON  Error  Messages 

CON  —  Bad  indirect  command  file  specification 

Explanation:  The  name  of  an  indirect  command  file  (@filename) 
was  specified  with  incorrect  syntax. 

CON  —  Command  execution  error 

Explanation:  CON  cannot  process  the  specified  command 

line.  (More  specific  information  is  also  given.) 

CON  —  Command  intent  inconsistent  with  device  state 

Explanation:  An  attempt  was  made  to  place  on  line  a  device  that 

is  in  the  marked  for  off-line  state. 

CON  —  Command  list  is  empty.  Nothing  to  print 

Explanation:  The  CON  LIST  command  was  issued  when  CON's  internal 

buffer  was  empty. 

CON  —  Command  syntax  error 

Explanation:  The  command  line  does  not  conform  to  command  syntax 

rules . 

The  command  is  displayed  with  a  question  mark  (?)  following  the 
last  recognized  keyword  or  parameter  typed  by  the  user.  Check 
the  command  description  for  correct  format  and  reenter  the 
command  line. 

CON  —  CONFIGURE  Version  nnn 

Explanation:  This  message  is  returned  by  the  CON  IDENT  command. 
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CON  —  CON  is  unable  to  do  an  extend  task  operation  to  obtain  pool  for 
a  read  of  the  system  configuration.  Please  ensure  that  a 
checkpoint  file  has  been  allocated  and  reissue  the  CON  command 

Explanation :  Self-explanatory . 

CON  —  File  open  error/FILE=f ilename/No  such  file 

Explanations  An  invalid  file  specification  was  used  with  the 
LIST  command.  Check  the  device  name  and  UFD  and  reenter  the 
command  line . 

CON  —  HRC  has  timed  out  during  initialization 

Explanations  This  message  could  indicate  an  error  in  the  I/O 
data  structure.  Please  verify  that  your  device  data  structures 
are  correct. 

CON  —  HRC  version  nnn 

Explanations  This  message  is  returned  by  the  CON  IDENT  command. 
CON  —  Illegal  command 

Explanations  The  command  is  not  a  valid  CON  command  or  a  valid 
command  was  used  illegally. 

CON  —  Illegal  keyword 

Explanations  The  keyword  is  not  valid  for  the  specified  CON 
command  or  a  valid  keyword  was  used  illegally. 

CON  —  Initialization  error 

Explanations  CON  was  unable  to  properly  initialize  itself  or  its 
links  with  the  RDs  driver  and  the  HRC...  task.  Verify  that  the 
driver  is  loaded  and  that  HRC...  is  installed. 

CON  —  Initialization  request  of  HRC...  has  failed.  Please  ensure  that 
HRC...  is  installed. 

Explanations  CON  is  unable  to  start  HRC  running. 

CON  —  Input  error  on  input  command  file 
FILE=filename 

Explanations  The  file  you  have  specified  exists,  but  CON  could 
not  read  it. 

CON  —  Internal  consistency  error 

Explanations  An  error  internal  to  either  CON  or  HRC  has 
occurred.  This  is  most  often  an  internal  addressing  trap  or  a 
malfunctioning  driver.  Submit  a  Software  Performance  Report 
(SPR)  if  the  problem  seems  to  be  with  DIGITAL-standard  software. 

CON  —  Internal  core  pool  exhausted 

Explanations  CON  has  run  out  of  internal  pool  space  or  was 
invoked  without  checkpoint  space  first  being  allocated.  If  out 
of  pool  space,  check  the  / MAXEXT  setting.  (See  the  description 
of  the  SET  command  in  the  RSX-11M/M-PLUS  MCR  Operations  Manual . ) 
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CON  —  Maximum  indirect  command  file  depth  exceeded 

Explanation:  You  have  specified  that  CON  use  an  indirect  command 

file  that  exceeds  CON's  maximum  nesting  depth  of  three. 

CON  —  No  device  name  matches  select  string 

Explanation:  You  have  specified  with  the  DISPLAY  command  a 

logical  device  name  that  does  not  exist  in  the  system. 

CON  —  No  HRC  version  information  available 

Explanation:  This  message  is  returned  by  the  CON  IDENT  command 

if  HRC  is  not  installed. 

CON  —  No  reconfiguration  driver  is  available 
Output  to  HRC  is  suppressed 

Explanation:  The  reconfiguration  driver  (RD: )  is  not  loaded  in 

the  system. 

CON  —  Open  error  on  input  command  file 
FILE=f ilename 

Explanation:  The  input  file  you  have  specified  does  not  exist. 

CON  —  Unable  to  assign  command  LUN 

Explanation:  CON  was  unable  to  assign  its  command  input  LUN  to 

TI:  . 

CON  —  Unknown  command  error 

Explanation:  For  undetermined  reasons,  CON  cannot  read  the 

command . 

CON  —  Unknown  device  or  invalid  device  specification 

Explanation:  The  device  specified  for  a  command  other  than  the 

DISPLAY  command  is  not  known  to  the  system.  Consult  the  system 
configuration  for  the  proper  name  of  the  target  device. 

CON  —  You  must  be  privileged  to  modify  the  system  configuration 

Explanation:  The  command  specified  in  the  command  line  must  be 

issued  from  a  privileged  terminal. 


15.9.2  HRC  Error  Messages 

The  following  messages  are  related  to  HRC  but  also  come  from  CON. 

Attempt  to  quiet  unit  for  controller  failed 

Explanation:  When  a  controller  with  units  on  line  is  taken  off 
line,  the  on-line  units  are  quieted  and  set  to  the  marked  for 
on-line  state.  HRC  attempts  to  access  the  unit  when  it  does  not 
have  context  and  can  be  taken  off  line.  HRC  makes  1000 ( decimal ) 
attempts  to  quiet  the  device.  If  the  device  has  not  been 
successfully  accessed  after  the  1000  attempts,  CON  displays  this 
message. 


15-39 


RSX-11M-PLUS  SYSTEM  RECONFIGURATION 


Attribute  format  error 

Explanation:  HRC  received  a  read  or  write  attributes  QIO  in 

which  the  desired  attributes  were  either  incorrectly  specified  or 
inappropriate  for  the  specified  device. 

CSR  for  controller  not  present  in  I/O  page 

Explanation:  An  attempt  was  made  to  bring  on  line  a  controller 

that  does  not  exist  in  the  current  hardware  configuration. 

Device  already  linked 

Explanation:  A  LINK  command  was  issued  for  a  bus  run  that  is 

already  linked  to  a  CPU. 

Device  not  linked 

Explanation:  An  UNLINK  command  was  issued  for  a  bus  run  that  is 

not  currently  linked  to  a  CPU. 

Device  is  unknown  in  this  configuration 

Explanation:  HRC  has  received  a  request  to  bring  on  line  a 

device  that  is  unknown  because  it  had  been  previously  assigned  a 
CSR  address  of  160000  or  less. 

Executive  or  driver  status  change  error 

Explanation:  During  a  controller  on-line  or  off-line  operation, 

either  the  executive  controller  status  change  routines 
( $0NKRB / $0FKRB )  or  the  driver's  controller  status  change  routine 
(xxKRB)  were  unable  to  change  the  state  of  the  controller. 

HRC...  can't  take  box  offline.  Not  last  box  in  memory 

Explanation:  An  attempt  was  made  to  take  off  line  a  memory  box 

that  is  not  at  the  end  of  the  current  physical  memory 
configuration . 

HRC...  can't  take  box  offline.  Partition  overmaps  box 

Explanation:  An  attempt  was  made  to  take  a  memory  box  off  line, 

but  the  memory  is  currently  in  use  for  a  partition.  The 
partition  must  either  be  removed  with  SET  /NOPAR  or  reduced  in 
size  with  SET  /TOP  (see  the  RSX-11M/M-PLUS  MCR  Operations 
Manual ) . 

HRC...  detected  I/O  data  base  consistency  error 

Explanation:  During  the  course  of  taking  a  device  off  line,  HRC 

detected  an  error  in  the  structure  of  the  system  device  data 
base . 

HRC...  internal  addressing  error 

Explanation:  An  odd  address  trap  (or  other  software  trap)  has 

occurred  within  HRC.  This  may  be  due  to  a  bug  in  HRC  or  an 
inconsistency  in  the  system's  I/O  data  base. 
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HRC . . .  internal  tables  insufficient  for  this  system 

Explanation:  HRC  creates  a  list  of  units  on  the  stack  when 

taking  a  controller  off  line.  This  message  is  produced  if  HRC 
encounters  a  controller  with  too  many  units  to  create  a  list. 
The  maximum  number  of  units  for  each  controller  is  defined  by  the 
symbol  . MXCTL  in  HRPRE  and  is  currently  set  to  256 (decimal ) . 

HRC...  invalid  device  specification 

Explanation:  HRC  received  a  request  to  bring  memory  on  line,  but 

the  specified  device  was  not  a  memory  box. 

HRC...  request  format  error 

Explanation:  HRC  received  a  QIO  in  which  the  format  of  the 
parameters  was  incorrect.  If  the  issuing  task  for  the  request 
was  CON,  this  error  implies  a  software  fault. 

HRC...  unable  to  access  device  to  size  drive 

Explanation:  When  certain  types  of  device  units  are  brought  on 

line,  HRC  must  "size"  the  drive  (for  example,  to  determine  if  a 
DB:-type  device  is  an  RP05  or  an  RP06 ) .  This  message  is  issued 
if  the  sizing  process  fails  for  any  reason  (for  example,  the 
drive  is  not  powered  up  when  the  CON  ONL  command  is  issued) . 

HRC...  unknown  error  from  online/of f line  call 

Explanation:  HRC  received  from  the  driver  on-line/off-line  call 

an  unsuccessful  status  that  is  n'ot  one  of  the  normally  expected 
return  codes . 

Invalid  device  descriptor 

Explanation:  HRC  received  a  request  to  take  a  port  off  line,  but 

the  port  description  was  invalid. 


Memory  box  parameter  error 

Explanation:  An  attempt  has  been  made  to  bring  on  line  a  set  of 
memory  boxes  whose  current  physical  configuration  does  not  allow 
the  specified  command  to  be  executed. 

Offline  controller  failure 

Explanation:  HRC  attempted  to  take  a  controller  off  line,  but 
the  controller  did  not  properly  change  state.  However,  no 
explicit  error  was  recognized. 

Offline  unit  failure 

Explanation:  HRC  attempted  to  take  a  unit  off  line,  but  the  unit 
did  not  properly  change  state.  However,  no  explicit  error  was 
recognized . 

Parameter  error 

Explanation:  HRC  received  a  request  to  link  a  bus  run,  but  the 
device  specified  was  not  a  bus  switch.  If  the  requesting  task 
was  CON,  this  probably  implies  a  software  fault. 
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Syntax  error 

Explanation:  HRC  received  a  command  to  link  a  bus  run  to  a 

device  that  is  not  a  CPU. 

Timeout  on  unit  quieting  operation 

Explanation:  HRC  was  unsuccessful  in  attempting  to  "catch"  a 

unit  in  its  quiet  state  to  take  it  off  line  after  1000 ( decimal ) 
attempts . 

Unable  to  access  bus  run 

Explanation:  HRC  was  unable  to  create  or  remove  the  vectors  for 

a  device  because  the  device's  bus  run  was  inaccessible.  Because 

HRC  checks  bus  run  status  and  uses  the  marked  for  on-line  state 
for  devices  on  off-line  bus  runs,  this  message  probably  implies  a 
software  fault. 

Unable  to  switch  unit  from  the  current  controller 

Explanation:  This  error  is  displayed  for  two  reasons: 

1.  HRC  attempted  to  take  off  line  the  controller  for  a  port  to 
which  the  bus  switch  is  currently  switched. 

2.  HRC  attempted  to  take  off  line  a  controller  (with  units) 
whose  access  path  cannot  be  changed. 

Unable  to  take  unit  with  context  offline 

Explanation:  An  attempt  was  made  to  take  one  of  the  following 

units  off  line: 

•  A  mounted  Files-11  device 

•  An  attached  device 

•  A  logged-in  terminal 

•  A  bus  switch  whose  bus  run  is  currently  linked 

•  A  memory  box  unit  whose  memory  is  currently  on  line 
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I/O  Queue  Optimization  is  used  to  improve  the  throughput  of  the  disk 
subsystem  used  in  your  RSX-11M-PLUS  system.  Disk  throughput  is 
improved  by  making  the  most  effective  use  of  the  list  of  I/O  requests 
in  the  queue  for  a  particular  disk  device.  The  I/O  queue  for  the 
device  is  scanned  by  I/O  Queue  Optimization  and  after  each  request  is 
examined,  the  best  request  is  dequeued  and  passed  to  the  I/O  driver 
for  processing.  How  Queue  Optimization  determines  which  I/O  request 
is  best,  depends  on  which  method  of  I/O  Queue  Optimization  is  used. 
There  are  three  methods  of  I/O  Queue  Optimization  available  (you  can 
also  choose  not  to  have  I/O  Queue  Optimization): 

1.  Nearest  Cylinder 

2.  Elevator 

3.  Cylinder  Scan 

The  method  that  serves  you  best  depends  on  your  processing 
environment.  All  three  methods  attempt  to  minimize  head-seek  time, 
which  decreases  the  seek-time  component  of  the  file  service  time. 

Because  I/O  Queue  Optimization  works  by  optimizing  requests  in  the 
queue,  optimization  happens  only  when  I/O  requests  are  present  in  the 
queue.  If  the  system  loading  is  such  that  there  are  few,  if  any, 
requests  in  the  queue,  little  optimization  is  achieved. 

Without  I/O  Queue  Optimization,  the  operating  system  groups  the  I/O 
requests  in  the  queue,  by  priority,  on  a  first-in/first-out  basis. 
The  highest  priority  requests  appear  first  in  the  queue  and  are 
processed  in  sequence.  With  I/O  Queue  Optimization,  the  I/O  requests 
within  priority  groups  are  examined  and  the  request  having  the 
appropriate  disk  address  is  chosen  as  the  next  I/O  operation.  The 
highest  priority  requests  are  still  serviced  first;  however, 
throughput  is  increased  by  advantageous  reordering  of  requests  within 
priority. 

In  some  cases,  I/O  Queue  Optimization  may  provide  smoother  disk 
operation  by  reducing  erratic  head  movement. 


16.1  INITIATING  OPTIMIZATION 

The  MCR  SET  /OPT  command  is  used  to  initiate  I/O  Queue  Optimization. 
The  parameters  in  this  command  are  used  to  specify  the  disk  device, 
the  method  of  optimization,  and  a  fairness  count  limit  for  passed  over 
I/O  requests.  These  parameters  are  explained  in  detail  in  following 
paragraphs . 
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The  SET  command  is  only  for  privileged  users.  Nonprivileged  users  can 
use  this  command  only  to  display  the  optimization  status  of  devices  in 
the  system. 

Format : 

SET  / [NO] OPT [=ddn:opttype:fairnesscount. ] 

Parameters 

ddn 

The  disk  device  requiring  optimization: 

DBn  RP04,RP05,RP06  pack  disks 

DRn  RM02 , RM03,RM05, RM80 , RP07  pack  disks 

DMn  RK06  and  RK07  cartridge  disks 

DLn  RL01  and  RL02  cartridge  disks 

opt type 

The  type  of  optimization  needed: 

Initiates  Nearest  Cylinder  method;  next  request 
picked  is  the  closest  to  current  request 

Initiates  Elevator  method;  requests  are  processed 
first  in  one  direction  along  the  disk  and  then  in 
the  reverse  direction 

Initiates  Cylinder  Scan  method;  requests  are 
processed  in  only  one  direction  along  the  disk 
(lowest  to  highest) 

The  default  is  NEAREST. 

fairnesscount 

A  limit  on  the  number  of  times  the  most  unsatisfactory  I/O 
request  is  passed  over  (see  Section  16.2.1)* 

The  default  is  10. 


NEAR [EST] 
ELEV [ATOR] 

CSCAN 


16.1.1  Displaying  Optimization  Status 

You  can  display  the  optimization  status  for  all  devices  in  the  system 
that  are  currently  using  I/O  Queue  Optimization  by  entering  the 
following : 

>SFT  /OPT 

This  displays  status  in  the  following  form: 

OPT=ddn : opt type : fairnesscount 
For  example: 

opt=dbo:near: io* 

OPT ~DB1  ♦  F.LEVJ  5  ♦ 

OPT  =  DB2 t CSCAN  J  8  * 
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You  can  also  display  which  devices  are  not  using  I/O  Queue 
Optimization  by  entering: 

> 3 E T  /NO OPT 

This  displays  status  in  the  form: 

NOOPT=ddn: 

For  example : 

NO OPT -OR  1 ? 

Nonprivileged  as  well  as  privileged  users  can  display  status. 


16.2  SELECTING  THE  TYPE  OF  OPTIMIZATION 

Selecting  the  correct  optimization  method  is  dependent  upon  the  I/O 
processing  environment  in  which  your  application  is  running,  the 
physical  location  of  data  on  the  disk  drive,  and  how  often  tasks 
access  certain  data  areas. 

A  general  guideline  is  to  try  the  default  first.  (This  initiates  the 
Nearest  Cylinder  method  with  a  fairness  count  limit  of  10.)  Then 
compare  the  difference  in  throughput  by  timing  the  application  run 
time  against  a  suitable  clock.  For  a  closer  look  at  disk  activity  and 
throughput,  use  Resource  Accounting  (see  Chapter  17).  Resource 
Accounting  provides  this  data  under  the  heading  DEVICE  STATISTICS  in 
the  output  from  the  Resource  Accounting  transaction  file. 

The  default  (NEAREST,  and  a  fairness  count  of  10)  is  an  average 
setting  and,  in  most  cases,  should  improve  I/O  throughput.  As  you 
become  more  familiar  with  the  I/O  load  and  data  organization  on  the 
disk  in  your  application,  you  can  make  adjustments  by  changing  the 
fairness  count  limit  or  by  using  one  of  the  other  methods  of  I/O  Queue 
Optimization  (see  the  sections  following). 


16.2.1  Adjusting  the  Fairness  Count  Limit 

When  using  I/O  Queue  Optimization,  you  should  watch  for  increased 
waiting  time.  I/O  requests  to  some  data  areas  may  have  slower  than 
normal  access  times,  because  Optimization  categorizes  them  as 
unsatisfactory.  When  this  happens.  Optimization  passes  over  these 
requests  for  a  better  choice,  keeping  the  unsatisfactory  requests  in 
the  queue  longer.  This  may  cause  a  decrease  in  performance  for  some 
tasks  even  though  overall  system  performance  has  improved. 

To  counteract  increased  waiting  time  and  acquire  a  better  balance,  you 
can  adjust  the  fairness  count  limit.  This  places  a  limit  on  how  many 
times  an  I/O  request  can  be  passed  over.  Optimization  increments  the 
fairness  count  for  the  first  I/O  request  in  the  queue  whenever  that 
request  in  the  queue  is  passed  over.  When  the  fairness  count  for  an 
I/O  request  reaches  the  limit  indicated  with  the  SET  command,  the 
request  is  dequeued  and  the  fairness  count  is  cleared. 

Decreasing  the  fairness  count  limit  reduces  waiting  time  but  decreases 
the  overall  throughput  initially  gained  with  the  higher  count.  If  you 
find  you  must  decrease  the  fairness  count  limit,  try  another 
optimization  method.  It  may  be  more  applicable  to  your  situation. 


16-3 


RSX-11M-PLUS  I/O  QUEUE  OPTIMIZATION 


16.2.2  Nearest  Cylinder  Method 

The  Nearest  Cylinder  optimization  method  processes  the  I/O  request 
that  is  closest  to  the  current  cylinder.  In  general,  this  method  is 
effective  for  both  long  and  short  I/O  queues.  There  may  be  an 
increase  in  waiting  time,  however,  and  this  may  be  unacceptable  in  an 
interactive  environment.  To  remedy  this,  reduce  the  fairness  count 
limit  (which  reduces  the  throughput)  or  try  one  of  the  other 
optimization  methods.  (The  Elevator  method  may  be  the  next  best 
choice . ) 


16.2.3  Elevator  Method 

The  Elevator  optimization  method  processes  I/O  requests  like  an 
elevator.  It  processes  requests  as  it  moves  in  one  direction  along 
the  disk  until  it  reaches  the  last  request  in  that  direction. 
Elevator  then  changes  direction  and  processes  requests  in  that 
direction.  This  method  is  effective  if  there  are  many  I/O  requests 
outstanding.  Also,  waiting  time  tends  to  be  less  with  the  Elevator 
method  than  with  the  Nearest  Cylinder  method. 

The  Elevator  method  favors  the  center  of  the  disk.  Requests  are  done 
as  they  are  passed,  and  the  center  of  the  disk  tends  to  be  passed  over 
twice  as  often  as  the  periphery.  Therefore,  a  task  that  has  a  number 
of  requests  located  in  the  center  of  the  disk  tends  to  have  faster  I/O 
than  a  task  with  requests  at  the  periphery. 


16.2.4  Cylinder  Scan  Method 

The  Cylinder  Scan  optimization  method  operates  like  the  Elevator 
method  except  the  Cylinder  Scan  method  processes  I/O  requests  only 
while  passing  in  one  direction  along  the  disk.  The  direction  is  from 
the  lowest  cylinder  number  to  the  highest  cylinder  number.  This 
method  is  most  effective  if  each  task  tends  to  do  I/O  to  a  localized 
area  on  the  disk.  It  results  in  a  more  even  distribution  of  I/O  among 
tasks . 


16.3  ERROR  MESSAGES 
SET  —  Privileged  command 

Nonprivileged  users  can  display  status  only. 

SET  —  Feature  not  supported 

User  tried  to  initiate  Optimization  for  a  disk  device  that  does 
not  support  Optimization. 

SET  —  Device  not  in  system 

User  tried  to  initiate  Optimization  for  a  disk  device  that  is  not 
mounted  in  the  system. 

SET  —  Illegal  keyword  value 

User  specified  a  fairness  count  higher  than  128 (decimal ) . 
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SET  —  Invalid  keyword 

User  tried  to  use  an  invalid  keyword. 

SET  —  Device  offline  or  privileged  diagnostic 

User  tried  to  initiate  Optimization  for  an  off-line  device. 
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17.1  INTRODUCTION 

RSX-1 1M-PLUS  Resource  Accounting  is  a  system  generation  option  that 
provides  a  transaction  file  of  system  usage  information.  Accounting 
gathers  data  for  both  the  user  and  the  system.  The  data  allows  the 
billing  of  individual  users  for  the  resources  used,  as  well  as  the 
measuring  of  overall  system  usage. 

Some  of  the  system  usage  information  gathered  by  Resource  Accounting 
and  saved  in  the  transaction  file  is  as  follows: 

User  Data 

•  Session  identification,  terminal,  and  account  number 

•  Billing  stop  date  and  time 

•  CPU  usage  time 

•  Tasks  active  at  time  of  logout  or  crash 

•  Number  of  tasks  run 

•  Number  of  directives  and  QIOs  issued 

•  Status  at  logout  or  crash 
Task  Data 

•  Session  identification,  terminal,  and  account  number 

•  Disk  overlay  loads 

•  Number  of  times  checkpointed 

•  Number  of  times  context  has  been  loaded 

•  Highest  running  priority 

•  Task  begin  time  and  end  time 

•  CPU  usage  time 

•  Number  of  directives  and  QIOs  issued 

•  Status  at  logout  or  crash 
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System  Data 

•  Accounting  start  date  and  time 

•  Accounting  stop  date  and  time  (0  if  system  crashes) 

•  Shutdown  code 

•  Transaction  file  ID,  sequence  number,  and  device 

•  Last  scan  date,  time,  and  scan  rate  in  seconds 

•  Total  CPU  time  and  total  CPU  zero  intervals 

•  Total  number  of  tasks  executed 

•  Total  number  of  logins 

•  Number  of  current  users 

•  Number  of  checkpoints 

•  Number  of  Shuffler  runs 

•  Number  of  directives  issued 

•  Number  of  QIOs  issued 
Login  Data  or  Invalid  Login  Data 

•  User  name,  ID,  terminal,  and  account  number 

•  Login  UIC,  date,  and  time 

•  Illegal  password 

Device  Allocation,  Deallocation  Data,  or  Dismount  Data 

•  Session  ID,  terminal,  and  account  number 

•  Allocation  or  deallocation  date,  time,  and  device 
Device  Mount 

•  Session  ID,  terminal,  and  account  number 

•  Mount  date,  time,  and  device 

•  Volume  label  for  Files-11  mounted  device 

•  Type  of  mount  (foreign,  shared,  and  so  on) 

•  Owner  UIC 

•  Volume  protection  code 

•  Name  of  ACP  for  device 
Print  Job  Data 

•  Session  ID,  terminal,  and  account  number 

•  Print  job  date  and  time 

•  Job  name  and  page  count 
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•  Number  of  files  printed,  printer  device,  and  forms  number 

•  Job  priority 
Card  Reader  Job  Data 

•  Session  ID,  terminal,  and  account  number 

•  Batch  or  print  job  name 

•  Number  of  cards  read 

•  Reader  device  name  and  number 
System  Time  Change 

•  Old  Time 

•  New  Time 
Device  Usage  Data 

•  I/O  counts 

•  Error  counts 

•  Tuning  information 

There  are  several  ways  to  access  the  system  usage  information 
contained  in  the  transaction  file.  They  are  as  follows: 

•  The  SHOW  ACCOUNTING  commands  (see  Section  17.3): 

-  SHOW  ACCOUNTING/INFORMATION  displays  system  usage 
information  about  specific  terminals. 

-  SHOW  ACCOUNTING/TRANSACTION_FILE  generates  a  formatted 
version  of  the  transaction  file. 

•  A  report  program  written  by  DATATRIEVE-11  (see  Section  17.4) 

•  User-written  analysis  programs  (see  Section  17.5) 

Resource  Accounting  gathers  system  usage  information  by  collecting  the 
data  in  account  blocks  in  secondary  pool  and  writing  each  account 
block  as  a  record  in  the  transaction  file.  These  account  blocks  are 
as  follows: 

•  Task  Account  Block  (TAB) 

•  User  Account  Block  (UAB ) 

•  System  Account  Block  (SAB) 

•  Transaction  account  blocks 

For  a  description  of  account  blocks,  their  structure,  and  how  Resource 
Accounting  uses  them,  see  Section  17.6. 

The  following  sections  describe  the  Resource  Accounting  commands. 
Parameters  are  separated  by  spaces,  you  may  abbreviate,  and  you  are 
prompted  for  missing  parameters.  All  commands,  except  SHOW 
ACCOUNTING/INFORMATION,  are  privileged.  (Slashes  in  SET  and  SHOW 
commands  are  optional . ) 
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The  Resource  Accounting  commands  are: 
START / ACCOUNT I NG 

STOP /ACCOUNTING 

SET  ACCOUNTING 

SHOW  ACCOUNTING/ INFORMATION 


Starts  up  the  Accounting 

subsystem 

Shuts  down  the  Accounting 

subsystem 

Changes  parameters  in  a  started 
Accounting  subsystem 

Displays  Accounting  information 
about  a  specific  terminal 


SHOW  ACCOUNTING/TRANSACTION_FILE  Converts  the  transaction  file 

to  a  readable  format  so  it  can 
be  displayed  on  a  terminal  or 
put  in  a  file 

SHOW  ACCOUNTING/DATATRIEVE  Converts  a  transaction  file  to 

a  file  that  is  readable  by 
DATATRIEVE-11 . 
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START/ACCOUNTING 


17.2  CONTROL  COMMANDS 

17.2.1  START/ ACCOUNTING  Command 

The  START /ACCOUNTING  command  starts  up  the  Accounting  subsystem.  The 
SYSLOG  and  ...ACC  tasks  must  be  installed  before  you  issue  the 
START/ ACCOUNTING  command.  If  you  do  not  supply  the  optional 
parameters,  they  assume  defaults. 

Format 

START/ACCOUNTING  [parameterl ][parametern] 

Parameter 
FILE: filespec 

This  file  specification  is  the  name  of  the  transaction  file  that 
Accounting  creates  to  store  the  data.  You  can  name  the  file  with 
this  parameter  or  accept  the  default,  LB : [1 , 6]ACNTRN . SYS . 

EXTENDJSIZE  rvalue 

This  value  is  the  size  of  the  initial  allocation  for  the 
transaction  file  and  for  each  extension  when  it  is  needed.  The 
value  can  be  any  reasonable  amount.  If  there  is  low  Accounting 
activity,  a  small  extension  size  is  adequate  because  few 
extensions  are  required  and  overhead  is  low.  If  Accounting 
activity  is  high,  a  larger  extension  size  lowers  the  overhead  if 
disk  space  is  available  for  the  larger  extension. 

The  default  value  is  10(10)  blocks. 

POOL_RESERVE : decimal  value 

This  value  is  the  number  of  blocks  of  secondary  pool  that 
Accounting  must  leave  free  after  each  allocation.  If  Accounting 
cannot  leave  this  amount  free,  the  allocation  will  fail  and 
prevent  the  swamping  of  secondary  pool. 

The  default  is  a  quarter  of  the  total  secondary  pool  size.  Use 
of  the  default  is  recommended. 

SYSTEM_STATISTICS: yes/no 

This  parameter  specifies  to  Accounting  whether  or  not  to 
accumulate  system-wide  statistics.  System-wide  statistics  are 
the  contents  of  the  accumulation  fields  in  the  System  Account 
Block.  These  fields  are  as  follows: 

•  B . CPU  Total  CPU  time  used 

•  B.DIR  Total  directive  count 

•  B.QIO  Total  QIO$  count 

•  B.TAS  Total  task  count 
The  default  is  yes. 
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START/ACCOUNTING  (Cont.) 


STATISTICS_SCAN[ svalue] 

This  value  specifies  a  scan  race  for  the  collection  of  device 
statistics.  These  device  statistics  are  used  mainly  to  measure 
seek-optimization  parameters.  They  also  provide  excellent 
information  on  disk  activity  and  throughput.  The  device 
statistics  are  collected  either  once  or  periodically.  To 
indicate  a  one-time  only  collection,  no  value  is  specified.  To 
collect  statistics  periodically,  the  value  specifies  the  rate  in 
minutes  (nM)  or  seconds  (nS).  The  default  value  is  one  hour  if 
SYSTEM_STATISTICS : YES  is  specified. 

If  STATISTICS  JSCAN  is  specified,  SYSTEM_STATISTICS  must  be 
specified.  This  restriction  does  not  apply  to  a  one-time  only 
request.  If  a  value  of  0  is  specified  or  SYSTEM_STATISTICS :N0  is 
specified,  this  feature  is  turned  off.  The  example  below  shows 
the  type  of  statistics  collected  in  a  transaction  file. 

SCAN_RATE : decimal  value 

This  value  is  the  time  interval  between  the  periods  when 
Accounting  writes  the  SAB  and  active  UABs  to  the  scan  file  called 
LB : [ 1 , 6 ] SYSSCAN . TMP  for  protection  against  loss  in  event  of  a 
system  crash.  The  value  can  be  supplied  as  "nM"  or  "n"  for  n 
minutes,  or  "nS"  for  seconds.  If  you  specify  0,  no  scanning  is 
done;  therefore,  if  the  system  crashes,  the  active  UABs  and  the 
SAB  are  not  recorded  in  the  transaction  file  and  the  data  is 
lost . 

The  default  value  is  5  minutes . 

If  Accounting  finds  a  scan  file  when  you  start,  it  outputs  a 
crash  transaction  and  copies  the  data  in  the  scan  file  to  the  new 
transaction  file.  A  copy  of  this  crash  transaction,  followed  by 
the  transaction  file,  is  shown  as  the  output  of  the  SHOW 
ACCOUNTING/TRANSACTION_FILE  command  in  Section  17.3.2. 
Accounting  copies  all  the  old  data  before  it  writes  the  startup 
transaction  and  before  it  processes  any  new  data. 

When  you  stop  Accounting,  the  scan  file  is  deleted. 

CRASH_REASON : yes/no 

If  you  enter  "yes"  and  Accounting  is  started  after  a  crash  that 
occurred  when  scanning  was  active.  Accounting  prompts  you  to 
enter  a  reason  for  the  crash.  The  reason  can  be  as  many  as  60 
characters  in  length  and  is  stored  in  the  Crash  Recovery 
Transaction  Block.  Accounting  prompts  for  "reason  for  crash" 
when  Accounting  is  restarted.  If  the  system  did  not  crash,  no 
prompt  occurs . 

If  you  enter  "no",  a  prompt  never  occurs;  the  default  is  no. 

TASK : yes/ no 

If  you  enter  "yes,"  task  accounting  is  initiated.  Task 
accounting  gathers  data  on  individual  tasks  running  in  the 
system.  You  can  run  task  accounting  when  the  system  is  running 
at  peak  load  times  and  the  task  accounting  data  can  be  analyzed 
on  a  per  task  basis  to  identify  heavy  resource  users. 
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START/ACCOUNTING  (Cont.) 


If  you  enter  "no,"  task  accounting  is  stopped.  The  default  is 
no . 

Task  accounting  should  only  be  specified  when  you  absolutely  need 
task  accounting  data.  The  reason  is  that  task  accounting 
requires  substantial  disk  space  because  the  transaction  file  can 
become  quite  large. 

Example 

The  type  of  device  statistics  collected  by  Resource  Accounting  is 
shown  in  the  following  output  from  a  transaction  files 

Device  Statistics 

Time  of  Device  Statistics  *  15-DEC-85  16:274*23  Device  =  DR1 
10  Count  »  0*  Words  Transferred  Count  -  0* 

Soft  Error  Limit  =  8*  Soft  Error  Count  =  0. 

Hard  Error  Limit  ~  5*  Hard  Error  Count  =  0* 

Cylinder  Crossed  Count  ~  0*  Current  Fairness  Count  =  0* 

Fairness  C o u ri t  L i. m it  =  10* 


Device  Statistics 

Time  of  Device  Statistics  *  15-DEC-85  16:27:23  Device  =  DR2 
10  Count  «  13832*  Words  Transferred  Count  =  9002804* 

Soft  Error  Limit  =  8*  Soft  Error  Count  =  0* 

Hard  Error  Limit  *  5*  Hard  Error  Count  -  0* 

Cylinder  Crossed  Count  =  1053  Current  Fairness  Count  =  0* 

Fairness  Count  Limit  ~  10* 


Device  Statistics 

Time  of  Device  Statistics  -  15-DEC-85  16:27:24  Device  =  DR3 
10  Count  ~  68490 ♦  Words  Transferred  Count  =  80640306* 

Soft  Error  Limit  -  8*  Soft  Error  Count  =  0* 

Hard  Error  Limit  =  5 ♦  Hard  Error  Count  =  0* 

Cylinder  Crossed  Count  ~  313*  Current  Fairness  Count  =  7* 

Fairness  Count  Limit  ■=  10* 

Some  definitions  are  as  follows: 


•  10  COUNT  -  The  number  of  I/O  requests. 

•  WORDS  TRANSFERRED  COUNT  -  The  number  of  words  transferred. 

•  SOFT  ERROR  -  A  recovered  error. 

•  HARD  ERROR  -  A  nonrecovered  error.  (See  the  RSX-11M/M-PLUS 
Error  Logging  Reference  Manual  for  more  information  about  hard 
and  soft  errors . ) 

•  CYLINDER  CROSSED  COUNT  -  The  number  of  cylinders  crossed  while 
accessing  data.  This  data  can  be  analyzed  for  I/O  Queue 
Optimization  purposes . 

•  FAIRNESS  COUNT  -  A  Queue  Optimization  parameter  that  indicates 
how  many  times  an  I/O  request  was  passed  over  (see  Chapter 
16)  . 
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SET  ACCOUNTING 

17.2.2  SET  ACCOUNTING  Command 

This  command  allows  you  to  change  the  value  of  parameters  specified 
when  Resource  Accounting  was  started  with  the  START/ACCOUNTING  command 
or  previously  modified  with  a  SET  command.  (A  transaction  is  written 
containing  the  old  value  and  the  new.) 

The  following  options  can  be  changed  while  Resource  Accounting  is 
runnings 

•  The  file  that  transactions  are  written  to 

•  The  size  of  the  extensions 

•  The  scan  rate  for  the  scan  file 

•  The  scan  rate  for  collecting  device  statistics 

•  The  state  of  task  accounting  (on  or  off) 

Format 


SET  ACCOUNTING/[parameterl][parametern] 

Parameter 
FILE[ s  filespec] 

Changes  the  file  that  transactions  are  written  to.  Defaults  to 

the  current  file  specification,  if  not  specified. 

EXTEND_SIZE  s  value 

This  value  changes  the  size  for  each  extension  of  the  transaction 
file  specified  in  the  START/ACCOUNTING  EXTENDJSIZE  parameter. 

STATISTICS _SCAN : value 

This  value  changes  the  scan  rate  for  collecting  device 
statistics.  A  value  of  0  stops  this  option. 

SCAN_RATE : value 

This  value  changes  the  scan  rate  for  the  scan  file  specified  in 
the  SCANJRATE  parameter.  A  value  of  0  stops  this  option. 

TASK: yes /no 

If  you  enter  "yes,"  task  accounting  is  started. 

When  specified,  task  accounting  creates  task  account  blocks  for 
all  active  tasks  in  the  system.  All  data,  for  each  task,  is 
gathered  starting  at  this  time. 

If  you  enter  "no,"  task  accounting  is  stopped. 


RSX-1 1M-PLUS  RESOURCE  ACCOUNTING 


SET  ACCOUNTING  (Cont.) 


When  specified,  task  accounting  on  a  per  task  basis  is  terminated 
and  the  data  for  all  active  tasks  is  written  to  the  transaction 
file.  The  only  exception  is  tasks  that  have  a  CPU  time  limit 
specified,  because  the  data  is  necessary  for  the  time  limit  to  be 
checked.  The  data  for  these  tasks  is  written  to  the  transaction 
file  when  the  task  exits. 
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STOP/ACCOUNTING 


17.2.3  STOP/ ACCOUNTING  Command 

This  command  shuts  down  the  Resource  Accounting  subsystem.  The 
parameter  is  provided  to  indicate  why  the  shutdown  is  occurring  and 
must  be  entered  with  the  command.  Accounting  puts  the  reason  for 
stopping  into  the  System  Account  Block. 


Formats 


STOP /ACCOUNTING  reason 
STOP/ACCOUNTING  CLEAN_UP 
Reason 
MAINTENANCE 

You  can  use  this  reason  when  you  stop  Accounting  for  system 
maintenance . 


REBOOT 


You  can  use  this  reason  if  you  must  rebootstrap  the  system. 
SCHEDULED_SHUTDOWN 

You  can  use  this  reason  when  the  system  is  being  shut  down  or 
used  for  other  purposes  where  Accounting  is  not  applicable. 


SHUTUP 


The  SHUTUP  program  uses  this  reason  as  a  default  because  it  has 
no  means  of  determining  a  shutdown  reason. 


OTHER 


You  can  use  this  reason  when  any  of  the  above  reasons  are  not 
adequate . 

The  STOP/ACCOUNTING  CLEAN_UP  command  has  a  special  use.  It  must  be 
used  if  the  SYSLOG  task  aborts  or  Accounting  encounters  a  fatal  error. 
This  command  cleans  up  all  the  data  structures  to  allow  Accounting  to 
restart  successfully.  Accounting  accepts  this  command  only  if  it  is 
necessary  (after  an  Accounting  failure  or  abort). 

When  you  use  this  command,  the  system  assumes  all  Accounting  data  in 
memory  to  be  invalid  and  deallocates  the  data  back  to  secondary  pool 
without  writing  it  to  the  transaction  file.  Note  that  if  the 
Accounting  data  structures  are  corrupted,  the  system  may  crash  while 
it  attempts  to  deallocate  secondary  pool. 

You  can  restart  Accounting  normally  after  you  issue  this  command. 
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SHOW  ACCOUNTING/INFORMATION 


17.3  SHOW  COMMANDS 

17.3.1  SHOW  ACCOUNTING/INFORMATION  Command 

This  command  displays  on  the  terminal  from  which  the  command  was 
issued  the  Accounting  information  for  the  specified  terminal. 
Nonprivileged  users  can  receive  only  their  Accounting  data.  A 
privileged  user  can  obtain  any  Accounting  data. 

Format 

SHOW  ACCOUNTING/ INFORMATION [parameter] 

Parameter 
TTn : 

If  you  specify  TTn:,  this  command  displays  the  Accounting  data 
for  the  specified  terminal.  A  privileged  user  has  access  to  the 
Accounting  data  of  any  terminal  on  the  system.  A  nonprivileged 
user  can  only  get  his  own  data.  The  default  terminal  is  TI : . 

If  you  enter  no  terminal  name,  the  Accounting  data  of  the 
terminal  issuing  the  command  is  displayed. 


CO: 


SYS 


If  you  specify  CO:,  the  Accounting  data  of  the  system  tasks 
running  is  displayed  on  the  terminal. 


If  you  specify  SYS,  the  current  system  totals  are  displayed  on 
the  terminal . 


TASK=taskname 


Shows  Accounting  data  for  the  specified  task  if  the  system  is 
maintaining  task  accounting. 
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SHOW  ACCOUNTING/TRANSACTION — FILE 


17.3.2  SHOW  ACCOUNTING/TRANSACTION_FILE  Command 

The  SHOW  ACCOUNTING/TRANSACTION__FILE  command  converts  the  transaction 
file  into  a  readable  format.  It  either  displays  this  file  on  a 
terminal  or  writes  it  into  another  file.  The  SHOW  ACCOUNTING/ 
TRANSACTION_FILE  command  uses  the  current  transaction  file  as  the 
default  file.  (When  Accounting  is  not  running,  there  is  no  default 
file . ) 

Format 

SHOW  ACCOUNTING / TRANSACT I ON_F I LE [ : inputf ilespec]  outputf ilespec 
Parameter 
inputf ilespec 

The  input  file  is  the  transaction  file  to  be  read.  If  you  do  not 
specify  an  input  file,  the  current  transaction  file  is  used. 

outputf ilespec 

The  output  file  can  be  either  a  terminal  (specified  as  TTn:  or 

TIs)  or  a  file  of  your  choice. 


Notes 


UIC  [126,10]  on  the  distribution  kit  includes  the  source  code  for 
the  SHOW  ACCOUNTING/TRANSACTION_FILE  command  to  serve  as  an 
example  for  how  to  read  the  file.  Note  that  the  record  size  in 
the  file  is  equal  to  the  transaction  length.  The  only  exception 
to  this  is  the  Accounting  startup  transaction  that  only  occurs 
once  and  is  512(10)  bytes  long.  The  startup  transaction  consists 
of  a  header  only,  but  its  size  is  increased  to  512(10)  bytes  to 
force  a  file  extension.  See  Section  17.6  or  [126,10]  ACNDF.DOC 
on  the  distribution  kit  for  the  format  of  this  file. 

Example 

The  output  of  the  SHOW  ACCOUNTING/TRANSACTION__FILE  command  is  a 
formatted  display  of  the  transaction  file.  The  default  file  is 
the  transaction  file  named  in  the  START /ACCOUNTING  command.  This 
example  of  output  of  a  SHOW  ACCOUNTING/TRANSACT ION_FILE  command 
is  keyed  to  the  following  explanatory  comments: 


ACCOUNTING  DATA  -  CURRENT  FILE 


1 l-PFC-85  16*56*04 


SYSTEM  CRASH  RECORD  A 

TIME  OF  LAST  SCAN  =  7-DF.C-85  10*48*17  SCAN  RATE  (SEC)  =  300.  © 

RESTART  TIME  =  7-DEC-85  19*58: 15 
REASON  =  O 
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SHOW  ACCOUNTING/TRANSACTION _ FILE  (Cont.) 


USER  -  ALPHA  P  © 

SESSION  ID  =  F 1 1 43  TI*  -  TT40 

LOGIN  IJTC  *  £7,1113  LOGGED  ON 

LOGGED  OFF  =  00-000-00  00*00*00 
CPU  »  4461  ♦  TASKS  ACTIVE  a 

Q I OS  =  6215* 

STATUS  ACT  CRH 


t  ACCOUNT  =  1 ♦ 

=  7-DEC-85  08*58*53 
PILLING  STOPPED  =  7-DEC-85  10*48*1 
1*  TASKS  RUN  a  95  * 

DIRECTIVES  =  10240* 


7 


USER  -  SYSTEM  TASKS 

SESSION  ID  *  *SYO  TIS  -  COJ  ACCOUNT  a  0  ♦ 

LOGON  IJIC  a  £0,03  LOGGED  ON  a  6-DEC-85  15*48*16 

LOGGED  OFE  =  00-00-00  00*00*00  BILLING  STOPPED  a  7-BEC-85  10*48*17 

CPU  a  103866.  TASKS  ACTIVE  a  9*  TASKS  RUN  a  601* 

QIOS  a  128967*  DIRECTIVES  a  667250* 

STATUS  ACT  CRH 


TOTAL  SYSTEM  STATISTICS  © 

ACCOUNTING  STARTED  a  4-DEC-85  15*48*16 

ACCOUNTING  STOPPED  a  00-000-00  00 J 00 * 00  SHUTDOWN  CODE  a  0 
TRANS  FILE  ID  =  1422  SEQ  NUM  a  1  DEVICE  a  D  B 1  * 

LIME  OF  LAST  SCAN  a  7-DFC-85  10*48*17  SCAN  RATF  (SEC)  a  300* 

TOTAL  CPU  a  441264*  7ER0  CPU  INTERVALS  a  374665* 

TOTAI  TASKS  a  3236.  TOTAL  LOGONS  a  60* 

CURRENT  USERS  a  27*  CHECKPOINTS  =  23* 

SHF  RUNS  a  0*  DIRECTIVES  a  2373564*  QIOS  a  556015* 


ACCOUNTING  STARTUP 

ACCOUNTING  STARTED  a  7-riEC-S5  19*58: 16 


LOGIN  -  BETA  B 

SESSION  ID  a  RXPl 
LOGON  IJIC  a  £7,1023 


TIS  a  TT26J  ACCOUNT  a  0* 
TIME  a  7- DEC-85  19*58*35 


LOGIN  -  ALPHA  P 

SESSION  ID  a  El 12  TIS  =  TT55S  ACCOUNT  a  1* 

LOGON  IJIC  a  £7,1.113  TIME  a  7-DEC-85  20  J  05  J  44 


DEVICE  MOUNT 

SESSION  ID  a  FI 12  TIS  a  TT55S  ACCOUNT  a  j. 

TIME  a  7-DEC-85  20*  06**37  DEVICE  a  D R 1 S  VOL  ID  =  WELCOMEBACK 

OWNER  IJIC  a  £0,03  ACP  NAME  =F11ACP  VOL.  PROT  MASK  =  0 


USER  -  ALPHA 

SESSION  ID 
LOGON  IJIC 
LOGGED  OFE 
CPU  =  141. 
DIRECTIVES 


P 

FI 12  T I S  a  TT55S  ACCOUNT  a  1  * 

£7,1113  LOGGED  ON  a  7-DEC-85  20 S 05 * 44 

7-DEC-85  20*06*43  PILLING  STOPPED  a  7-BFC-85  20*06*43 

TASKS  ACTIVE  *  0*  TASKS  RUN  a  17* 

472*  QIOS  =  166* 


s 
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LOGIN  -  ONEGA  D 

SESSION  ID  =  RXP3  TIJ  =  TT37 J  ACCOUNT  =  4* 

LOGON  UIC  =  C7,711  TINE  »  7-DEC-85  20J08J11 


DEVICE  ALLOCATION 

SESSION  ID  =  RXP4  TIJ  =  TT37J  ACCOUNT  =  4* 

TINE  =  7-DEC-85  20J09J12  DEVICE  =  DLOJ 


LOGIN  -  THETA  D 

SESSION  ID  =  SPR5  TIJ  =  TT55J  ACCOUNT  =  O* 

LOGON  UIC  =  17,3271  TINE  =  7-DEC-85  20J09J14 


DEVICE  NOUNT 

SESSION  ID  -  RXP4  TIJ 

TINE  =  7-DEC-85  20J09J15 
OWNER  UIC  =  C7,1071  ACP 


=  TT37J  ACCOUNT  =  4* 

DEVICE  =  DLOJ  VOL  ID  = 

NANE  =  TSTACP  VOL  PROT  NASK  =  0 


DEVICE  DEALLOCATION 

SESSION  ID  =  RXP4  TIJ  =  TT37J  ACCOUNT  =  4* 

TINE  =  7-DEC-85  20J09J15  DEVICE  =  DLOJ 


USER  -  SYSTEN  TASKS 

SESSION  ID  =  $SYO  TIJ  =  COJ  ACCOUNT  =  0* 

LOGON  UIC  =  COrOl  LOGGED  ON  =  7-DEC-85  19J58J16 

LOGGED  OFF  =  00-000-00  OOJOOJOO  BILLING  STOPPED  =  7-DEC-85  20J13J21 
CPU  ®  1603 ♦  TASKS  ACTIVE  «  4.  TASKS  RUN  =  64* 

DIRECTIVES  =  2986. 


TOTAL  SYSTEN  STATISTICS 

ACCOUNTING  STARTED  =  7-DEC-85  19J58J16 
ACCOUNTING  STOPPED  *  7-DF.C-8!5  20J13J21 
TRANS  FILE  ID  =  205  SEG  NUN  =  20 

STATISTICAL  SCAN  RATE  (SEC.)  =  3600. 


TINE  OF  LAST  SCAN 
TOTAL  CPU  =  4260. 
TOTAL  TASKS  =  243 
CURRENT  USERS  =  1 
SHF  RUNS  *  0. 


=  7-DEC-85  20 J 13 J 17 


SHUTDOWN  CODE  =  4 
DEVICE  =  DROJ 
FILE  EXT.  SIZE  *  10. 
SCAN  RATE.  (SEC)  =  300. 


ZERO  CPU  INTERVALS  =  3063. 

TOTAL.  LOGONS  *  7. 
CHECKPOINTS  «  0. 


DIRECTIVES 


10241 < 


QIOS  =  4946. 


0  The  crash  reason  appears  here  if  Accounting  prompts  you  for  a 
reason  for  the  crash.  The  prompt  occurs  only  if  you  answered  yes 
to  the  CRASH_REASON  parameter  in  the  START/ACCOUNTING  command. 

0  To  minimize  loss  of  data.  Accounting  writes  the  SABs  and 

currently  active  UABs  to  a  temporary  file  every  n  seconds  or 
minutes  unless  you  specify  a  scan  rate  of  0  in  the 

START/ACCOUNTING  command.  The  process  of  writing  this  file  is 
called  a  scan.  When  you  restart  Accounting,  it  copies  any 
existing  temporary  file  of  Accounting  data  into  the  Accounting 
file  now  starting.  If  the  scan  rate  is  0,  the  SABs  are 

memory-resident  until  you  stop  Accounting  or  the  system  crashes. 
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Also,  the  currently  active  UABs  are  memory-resident  until  a  user 
logs  out.  Therefore,  if  a  crash  occurs  with  the  scan  rate  at  0, 
all  the  SAB  and  current  UAB  data  is  lost. 


@  The  User  Account  Block  (P.  Alpha)  shows  a  logged  out  date  and 
time  of  0  because  the  system  crashed.  There  may  or  may  not  be  a 
"status"  line  as  the  last  line  of  the  User  Account  Block.  The 
status  line  indicates  the  bit  setting  of  the  status  mask  byte 
(B.STM)  in  the  UAB.  Three  of  the  bits  have  external  importance 
and  cause  this  line  to  appear  if  they  are  on.  These  bits  are  as 
follows : 


ACT  (BS.ACT) 


Indicates  that  the  UAB  was  written  to  the 
file  while  still  active  (all  activity  had  not 
ceased) .  This  can  happen  when  UABs  are 
copied  from  the  scan  file,  or  when  all  the 
data  structures  are  written  out  because 
Accounting  has  stopped. 


LGO  (BS.LGO)  Indicates  that  the  user  has  logged  off  with 
tasks  remaining  active  or  with  clock  queue 
requests  pending. 


CRH  (BS.CRH)  Indicates  that  this  UAB  came  from  the  scan 
file  and  was  copied  into  the  transaction  file 
when  Accounting  was  started  after  a  system 
crash . 


o 


The  TOTAL  SYSTEM  STATISTICS  block  contains  the  shutdown  code  as  a 
digit  in  the  range  0  through  5.  These  digits  have  the  following 
meanings : 


0  Accounting  not  stopped  due  to  crash 


1  Maintenance 


2 

3 

4 

5 


Rebootstrap 
Scheduled  shutdown 
Shutup 
Other 


The  ZERO  CPU  INTERVALS  field  shows  the  possible  error  in  the  CPU 
time  measurements.  The  error  occurs  because  the  system  clock  is 
usually  run  at  60  Hz  and  is  slower  than  the  context  switch  time 
of  the  Executive.  Therefore,  a  task  can  sometimes  execute  for 
"zero"  ticks,  because  the  time  needed  for  its  execution  is  less 
than  the  resolution  of  the  clock.  Resource  Accounting  rounds 
each  zero  tick  to  one-half  tick  of  CPU  time  and  counts  them.  The 
ZERO  CPU  INTERVALS  field  contains  the  count  of  the  number  of  zero 
ticks  that  have  occurred. 
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17.4  WRITING  AN  ACCOUNTING  REPORT  PROGRAM  USING  DATATRIEVE-1 1 

The  data  collected  in  the  transaction  file  pertains  to  your  computing 
environment.  How  you  interpret  and  analyze  this  data  depends  on  your 
objectives.  For  instance,  are  you  interested  in  billing  or  system 

measurement?  To  obtain  the  Accounting  data  you  are  looking  for,  in 

the  form  you  want,  you  will  most  likely  write  your  own  report  program. 
This  program  accesses  the  transaction  file,  reads  the  required  data 
fields,  and  writes  a  report  containing  the  Resource  Accounting  data 
you  are  interested  in. 

One  way  to  write  this  specialized  report  is  to  use  DATATRIEVE-11 ;  but 
before  a  DATATRIEVE-11  program  can  access  the  transaction  file,  the 
file  must  be  converted  to  a  DATATRIEVE-11  readable  file.  To  convert 
the  file,  use  the  Resource  Accounting  SHOW  ACCOUNTING/DATATRIEVE 
command  (see  Section  17.4.1).  The  format  of  the  converted  file  is 

shown  in  LB: [126, 24jACNTRN.CMD  along  with  an  example  of  a  simple 

report  generator  written  in  DATATRIEVE-11. 

To  obtain  a  report  using  the  example  report  generator,  you  must 
perform  the  following: 

1.  Use  the  SHOW  ACCOUNTING  command  (see  Section  17.4.1)  to 
convert  the  appropriate  transaction  file  to  a  file  that  is 
readable  by  DATATRIEVE-11.  Name  the  file  ACCOUNT . DAT  (this 
is  the  name  used  in  ACNTRN.CMD,  for  example  purposes  only). 

2.  Copy  the  following  files  from  the  system  disk  to  your 
directory: 

[1, 2]QUERY.DIC 

[126,24 ] ACNTRN . CMD 

After  the  above  files  are  made  available,  use  the  following  command 
line  to  generate  a  report: 

>DTR  0ACNTRN ♦ CMD 

This  command  line  calls  DATATRIEVE-11  and  executes  the  DATATRIEVE-11 
commands  in  the  ACNTRN.CMD  file.  A  brief  description  is  then 
displayed  on  your  terminal  screen  with  a  portion  of  the  DATATRIEVE-11 
commands  that  make  up  the  report  generator.  After  this  you  are 
prompted  with  the  following: 

Enter  DEVICE  OR  FILE: 

You  then  enter  where  you  want  the  Resource  Accounting  information 
displayed.  The  information  can  be  displayed  on  a  device  or  directed 
to  a  file.  For  example,  the  device  could  be  your  terminal: 

Enter  DEVICE  OR  FILE:  Ti: 

If  you  wanted  to  put  the  information  in  a  file  named  ACT. REP,  the 
response  would  be: 

Enter  DEVICE  OR  FILE:  ACT* REP 

While  creating  the  report,  you  are  prompted  to  respond  with  where  the 
report  should  be  displayed.  These  prompts  appear  at  junctures  in  the 
report  generating  process  where  certain  parts  of  the  report  can  be 
either  displayed  or  directed  to  a  file.  For  example,  the  first  prompt 
you  receive  is  at  a  point  where  the  STARTUP  TRANSACTION  part  of  the 
report  can  be  displayed.  The  next  prompt  is  at  a  point  where  the 
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first  part  of  USER  ACCOUNT  BLOCK  TRANSACTION  can  be  displayed.  At 
each  prompt,  you  can  direct  that  part  of  the  report  to  the  same  report 
file,  a  different  report  file,  or  to  a  device. 

To  stop  the  Resource  Accounting  report  process  before  it  is  finished, 
you  must  abort  DTR .  If  this  is  done,  you  must  recopy  [1,2]  QUERY. DIC 
back  into  your  area  before  using  the  example  Resource  Accounting 
report  program. 


17.4.1  SHOW  ACCOUNTING/ DATATRIEVE  Command 

This  command  allows  you  to  write  your  own  Resource  Accounting  report 
generator  using  DATATRIEVE -11 .  This  command  is  used  to  convert  an 
existing  transaction  file  to  a  file  that  is  readable  by  DATATRIEVE-11 . 

Format 

SHOW  ACCOUNTING/DATATRIEVE[ strnsfilespec]  outfilespec 
Parameter 
trnsf ilespec 

Specifies  the  name  of  an  existing  Resource  Accounting  transaction 
file . 

outfilespec 

Specifies  the  name  of  the  output  file  where  the  converted 
transaction  file  is  to  reside. 


17.5  USER  TASK  INTERFACE  FOR  CREATING  TRANSACTIONS 

You  can  define  and  create  your  own  transactions  and  write  them  into 
the  transaction  file  by  using  specific  entry  points  in  the  Executive 
Accounting  module.  The  task  that  you  write  must  be  privileged.  The 
privileged  task  must  enter  the  system  state  (by  means  of  $SWSTK)  and 
call  one  of  the  following  entry  points  in  the  Executive  module  ACSUB: 
$QTRAN,  $QTRN1 ,  or  $QTRN2 . 

In  general,  before  calling  one  of  the  three  entry  points,  the  task 
must  have  the  address  in  register  RO  of  a  defined  area  (packet)  that 
is  within  the  task.  Also,  the  task  must  supply  in  the  packet  a  value 
for  B.LEN  and  B.TYP  (see  Section  17.6.2).  The  packet  contains  the 
header  and  the  information  that  is  to  be  written  as  a  transaction. 
The  action  taken  by  the  ACSUB  code  depends  on  the  entry  point  called 
by  the  privileged  task. 


17.5.1  Calling  $QTRAN 

The  $QTRAN  routine  automatically  fills  in  the  user-ID  fields  of  the 
packet  from  those  used  by  the  TI :  terminal  of  the  calling  task.  In 
effect,  this  shows  that  the  new  transaction  is  coming  from  the  same 
user  who  ran  the  task. 

To  call  this  entry  point,  the  task  must  have  the  address  of  the 
transaction  packet  in  register  RO.  The  two  fields,  B.LEN  (containing 
the  transaction  length)  and  B.TYP  (containing  a  transaction  code  from 
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128  through  255),  must  be  filled  in  and  contained  within  the  packet. 
$QTRAN  obtains  the  transaction  header  from  the  UAB  of  the  privileged 
task,  copies  the  header  except  for  B.LEN  and  B.TYP  into  the  packet, 
time-stamps  the  packet,  and  links  the  packet  into  a  queue  to  be 
written  into  the  transaction  file  by  the  SYSLOG  task.  $QTRAN  does  not 
alter  the  task's  space,  but  copies  the  packet  into  secondary  pool 
space  before  copying  the  header  and  queuing  the  packet  into  the  SYSLOG 
queue . 

Example  17-1  is  an  example  of  the  code  needed  to  call  $QTRAN. 


Example  17-1  Code  That  Calls  $QTRAN 
. MCALL  ACNDF$ 

ACNDF $  ;  DEFINE  ACCOUNTING  SYMBOLS 

TRAN:  . BLKB  B.MLEN 


This  area  contains  code  that 
describes  the  data  to  be 
written  into  the  transaction 
file. 


MOV 

#TRAN, RO 

; GET  PACKET  ADDRESS 

MOVB 

#BT . MOV , B . TYP ( RO ) 

; FILL  IN  TYPE 

MOVB 

#  B . MLEN , B . LEN ( RO ) 

7  FILL  IN  LENGTH 

CALL 

$SWSTK . 

7  SWITCH  TO  SYSTEM  STATE 

CALL 

$QTRAN 

7 TO  CALL  QUEUE  TRANSACTION  EXEC  ROUTINE 

17.5.2  Calling  $QTRN1 

The  $QTRN1  routine  allows  the  user-ID  fields  to  be  obtained  from  a 
specified  place,  instead  of  assuming  the  current  task. 

To  call  this  entry  point,  the  task  must  have  filled  the  B.LEN  and 
B.TYP  fields  within  the  packet  and  must  have  the  address  of  the 
transaction  packet  in  register  RO.  In  addition,  register  R1  must 
contain  an  APR  value  that  points  to  a  UAB  or  TAB  that  contains  the 
user-ID  data  that  should  be  copied  into  this  transaction. 

The  intent  is  that  the  privileged  task  will  write  a  transaction 
associated  with  another  task.  $QTRN1  time-stamps  the  packet  and 
obtains  the  transaction  header  from  the  UAB  of  the  other  task.  $QTRN1 
then  queues  the  packet  in  the  SYSLOG  queue  to  be  written  into  the 
transaction  file.  $QTRN1  does  not  alter  the  packet  within  the  task, 
but  copies  identifying  information  from  the  specified  UAB  into 
secondary  pool,  then  copies  data  into  the  packet,  and  queues  the 
packet  into  the  SYSLOG  queue. 

Example  17-2  is  an  example  of  the  code  needed  to  call  $QTRN1. 
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Example  17-2  Code  That  Calls  $QTRN1 


. MCALL  ACNDF$ 

ACNDF$  ; DEFINE  ACCOUNTING  SYMBOLS 


This 

example  assumes  that  R1 

contains  the  pointer 

to  the  TCB  of  the  task  for  which  the  transaction 

is  to 

be  posted . 

TRAN:  .BLKB 

B . MLEN 

7  START  OF  TRANSACTION 

MOV 

T.ACN(Rl) ,R1 

7 GET  OTHER  TASK'S  UAB  OR  TAB  ADDRESS 

BEQ 

10$ 

7  IF  EQ  NO  ACCOUNTING  DATA  PRESENT 

MOV 

#TRAN,R0 

7  POINT  TO  TRANSACTION  HERE 

MOVB 

#  BT . MOV , B . TYP ( RO ) 

7  FILL  IN  TRANSACTION  TYPE 

MOVB 

#B . MLEN , B . LEN ( RO ) 

? FILL  IN  TRANSACTION  LENGTH 

CALL 

$SWSTK,  . 

7  SWITCH  TO  SYSTEM  STATE 

7  TO  CALL  EXECUTIVE  ROUTINES 

CALL 

$QTRN1 

17.5.3  Calling  $QTRN2 

The  $QTRN2  routine  assumes  the  calling  task  completely  fills  in  the 
user-ID  area  of  the  transaction.  The  Executive  queues  the  packet  with 
no  modification ,  except  for  a  time  stamp. 

To  call  this  entry  point,  the  task  must  have  the  address  of  the 
transaction  packet  in  register  RO.  $QTRN2  does  not  obtain  a  header 
from  any  other  source.  Therefore,  except  for  the  transaction  time, 
the  privileged  task  must  have  completely  filled  in  the  transaction 
header  and  the  transaction  data  contained  within  the  packet.  $QTRN2 
fills  in  the  transaction  time  field  in  the  transaction  header  area  of 
the  packet  created  by  the  user  task  and  queues  the  complete  packet  to 
the  SYSLOG  queue  to  be  written  to  the  transaction  file. 

Example  17-3  is  an  example  of  the  code  needed  to  call  $QTRN2 . 

Example  17-3  Code  That  Calls  $QTRN2 

.MCALL  ACNDF$ 

ACNDF $  ; DEFINE  ACCOUNTING  SYMBOLS 


TRAN:  . BLKB  B.MLEN 


This  area  contains  the  code  that 
describes  the  header  and  data  to 
be  written  into  the  transaction 
file . 


(continued  on  next  page) 


17-19 


RSX-1 1M-PLUS  RESOURCE  ACCOUNTING 


Example  17-3  (Cont.)  Code  That  Calls  $QTRN2 


MOV  #TRAN , RO 

MOVB  #BT . MOV , B . TYP ( RO ) 

MOVB  #  B . MLEN , B . LEN ( RO ) 

MOV  UID, B . UID ( RO ) 

MOV  UID+2 , B . UID+2 ( RO ) 

MOV  ACN , B . ACN ( RO ) 

MOV  TID , B . TID  ( RO ) 

CALL  $SWSTK,  10$ 

CALL  $QTRN2 

RETURN 

10$: 


POINT  TO  TRANSACTION 

FILL  IN  TRANSACTION  TYPE 

FILL  IN  TRANSACTION  LENGTH 

USER  SESSION  ID 

SECOND  HALF 

ACCOUNT  NUMBER 

TERMINAL  ID 

SWITCH  TO  SYSTEM  STATE 


; TO  USER 


Figure  17-1  describes  the  privileged  task  interface  just  discussed. 
Section  17.6.2  contains  a  description  of  the  header  area  fields. 


17.6  ACCOUNT  BLOCKS 

There  are  two  types  of  Resource  Accounting  account  blocks :  the 
memory-resident  and  non-memory-resident  account  blocks.  The 
memory-resident  account  blocks  are  the  Task  Account  Block  (TAB),  the 
User  Account  Block  ( UAB ) ,  and  the  System  Account  Block  (SAB).  The 
Task  Account  Block  (TAB)  accumulates  accounting  data  per  task  and 
stays  in  secondary  pool  as  long  as  a  task  is  active.  The  User  Account 
Block  (UAB)  for  each  logged-in  user  accumulates  the  Accounting  data 
and  stays  in  secondary  pool  as  long  as  the  user  is  logged  on.  The 
system's  UAB  accumulates  data  for  tasks  running  on  terminal  CO:.  The 
SAB  stays  in  secondary  pool  and  accumulates  system  accounting  data  as 
long  as  Resource  Accounting  is  running. 

All  other  account  blocks  are  non-memory-resident;  that  is,  they  are 
created  and  filled  when  any  transaction  occurs,  copied  by  Accounting 
into  secondary  pool  and  immediately  written  into  the  transaction  file. 
After  these  operations  are  completed,  the  space  is  deallocated  back  to 
secondary  pool. 

All  of  the  blocks  have  a  header  area  that  contains  the  same  fields  and 
offsets.  In  addition,  the  TAB,  the  UAB,  and  the  SAB  have  data 
accumulation  field  areas  following  the  header.  All  data  accumulation 
fields  have  the  same  offsets.  The  information  specific  to  the  TAB, 
UAB,  and  SAB  follows  the  accumulation  areas. 

You  can  find  the  size  and  the  description  of  the  offsets  in  Section 
17.6.2.  The  offsets  are  grouped  logically;  the  header  offsets  are 
described  in  one  group,  the  accumulation  field  offsets  in  another 
group,  and  so  forth.  The  account  and  transaction  block  diagrams  in 
Section  17.6.1  show  how  these  groups  fit  together  to  make  a  functional 
account  and  transaction  block.  The  account  and  transaction  block 
diagrams  are  shown  before  the  offset  descriptions. 

Check  the  [126 , 10]ACNDF . DOC  file  on  the  distribution  kit  for  the 
correct  numeric  offsets  if  you  plan  to  write  a  program  that  uses  the 
offsets.  In  MACRO-11  programs,  use  the  symbolic  names  defined  by  the 
ACNDF$  macro  in  [ 1 , 1 ]EXEMC . MLB .  The  names  will  not  change  even  if 
their  associated  offsets  change. 
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CALLING  $QTRAN 
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DATA 
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Figure  17-1  Privileged  Task  Interface  Overview 
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17.6.1  Account  and  Transaction  Block  Diagrams 
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Task  Account  Block 
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User  Account  Block 
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System  Account  Block 
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Accounting  Startup  Transaction  Block 
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Crash  Recovery  Transaction  Block 
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Set  Accounting  Transaction  Block 
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Invalid  Login  Transaction  Block 
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2 

4 


10 

14 

16 

18 

20 

22 


B.LNK 


B.TYP 


B.LEN 


B.TIM 


B.UID 


B.ACN 


B.TID 


B.DNAM 


B.DUNT 


UNUSED 


B.DLEN 

ZK-600-81 

Allocate  Device  Transaction  Block 
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OCT  DEC 


0 

0 

B.LNK 

2 

2 

B.TYP 

B.LEN 

4 

4 

B.TIM 

12 

10 

B.UID 

16 

14 

B.ACN 

20 

16 

B.TID 

22 

18 

B.DNAM 

24 

20 

B.DUNT 

UNUSED 

26 

22 

B.DLEN==. 

ZK-601-82 


Deallocate  Device  Transaction  Block 


OCT 

0 

2 

4 


12 

16 

20 

22 

24 

26 


42 

44 

46 

50 

54 


DEC 


0 

B.LNK 

2 

B.TYP 

B.LEN 

4 

B.TIM 

10 

B.UID 

14 

B.ACN 

16 

B.TID 

18 

B.DNAM 

20 

B.DUNT 

UNUSED 

22 

B.DLBL 

34 

B.DMST 

36 

B.DUIC 

38 

B.DVPR 

40 

B.DACP 

44  B.MLEN 

ZK-602-82 


Mount  Device  Transaction  Block 
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OCT 

DEC 

0 

0 

B.LNK 

2 

2 

B.TYP 

B.LEN 

4 

4 

B.TIM 

12 

10 

B.UID 

16 

14 

B.ACN 

20 

16 

B.TID 

22 

18 

B.DNAM 

24 

20 

B.DUNT 

UNUSED 

26 

22 

B.DLEN==. 

ZK-603-82 


Dismount  Device  Transaction  Block 

OCT  DEC 


0  0 

2  2 

4  4 


12  10 


16  14 

20  16 

22  18 


30  24 


36  30 


System  Time  Change  Transaction  Block 


B.TMLN 


ZK-604-82 
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OCT 

0 

2 

4 


12 

16 

20 

22 

30 

32 

34 

36 

40 

41 


DEC 

0 

2 

4 


10 

14 

16 

18 

24 

26 

28 

30 

32 

33 


ZK-605-82 


Print  Despooler  Transaction  Block 

OCT  DEC 

0  0 

2  2 

4  4 


12  10 

16  14 

20  16 

22  18 

24  20 


43  35  B.LLEN 

ZK-606-82 

Login  Transaction  Block 


B.LLEN- 
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OCT  DEC 

0  0 

2  2 

4  4 


12  10 

16  14 

20  16 

22  18 


30  24 

32  26 

34  28 

36  30 

Card  Reader  Spooling  Transaction  Block 

OCT  DEC 

0  0 

2  2 

4  4 


12  10 

16  14 

20  16 

22  18 

26  22 

32  26 

34  28 

36  30 

42  34 

46  38 

50  40 

52  42 

54  44 

56  46 

Device  Statistics  Block 


B.LNK 


B.TYP 


B.LEN 


B.TIM 


B.UID 


B.ACN 


B.TID 


X.NAME 


X.IOC 


X.ERHL 


X.ERSL 


X.ERSC 


X.ERHC 


X.WCNT 


X.CYLC 


X.CCYL 


X.FCUR 


X.FLIM 


X.DNAM 


X.UNIT 


UNUSED 


X.LGTH  == 


ZK-902-82 


B.RLEN 

ZK-607-82 


^5 
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17,6.2  Account  and  Transaction  Block  Offset  Definitions 

The  header  area  fields  precede  the  accumulation  fields  for  the  TAB, 
UAB ,  and  SAB.  The  header  area  fields  also  precede  each  transaction 

block . 

The  header  provides  user  identification  by  two  fields  (B.UID  and 
B.ACN)  that  appear  in  every  transaction.  These  fields  are  the  unique 
session  identification  and  the  account  number.  The  unique  session 
identification  is  two  words  long.  The  first  word,  the  session 

identification,  is  three  RAD50  characters  supplied  by  the  user  when  he 

creates  the  system  account  by  using  the  ACNT  program.  The  second  word 
is  a  unique  number  assigned  by  the  system  at  login.  Thus,  it  is 
possible  to  match  every  transaction  with  the  login  session  that 
produced  it.  The  account  number  field  is  a  binary  word  (entered 
through  ACNT)  that  is  copied  into  every  transaction.  Resource 

Accounting  does  not  use  either  of  these  fields,  except  to  ensure  that 

they  appear  in  every  transaction. 


Header  Area  Fields 


Offset 


Size  or 

Value  Definition 


B . LNK : : 
B . TYP : : 


B.LEN: : 
B.TIMs : 


B.HID==. 
B.UID: : 


. BLKW  1 
. BLKB  1 


BT . SAB==1 
BT.UAB==2 
BT . TAB==3 
BT.SS==11 
BT. INV==12 
BT . TIM==13 
BT. ALL==14 
BT . DEA==15 
BT.M0U==16 
BT.DM0==17 
BT.PRT==20 


BT . LOG ==23 
BT . CRH==24 
BT.DST==25 
BT . RTP==26 
BT. INP==27 


Start  of  header  area: 

Link  to  next  in  SYSLOG  queue 
Transaction  type: 

000  through  127  -  reserved  for  DIGITAL 

use 

128  through  255  -  reserved  for  customer 

use 

System  Account  Block  (SAB) 

User  Account  Block  (UAB) 

Task  Account  Block  (TAB) 

Accounting  startup  transaction 
Invalid  login  transaction 
System  time  change  transaction 
Allocate  device  transaction 
Deallocate  device  transaction 
Mount  device  transaction 
Dismount  device  transaction 
Print  despooler  transaction 
Reserved 
Reserved 

Login  transaction 

Crash  recovery  transaction 

Device  Statistics  (UCB  Extension) 

Reset  Transaction  Parameters 
Card  Reader  Spooling  Transaction 


.BLKB  1 
.BLKW  3 


.BLKW  2 


Transaction  length  in  bytes 

Ending  time  of  transaction  (supplied  by 

$QTRAN , $QTRN1 , $QTRN2 ) 

Start  of  header  identification  area 
Unique  session  identification 
First  word  -  RAD50 
Second  word  -  binary 
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B.ACN: : 
B.TID: s 


B . HEND== . 


. BLKW  1  Account  number 

.BLKB  1  ASCII  terminal  type:  V  -  virtual, 

T  -  real,  B  -  batch,  C  -  console 
.BLKB  1  Unit  number 

End  of  header  identification  area 


Accumulation  Fields  for  User  Account  Block,  Task  Account 
Block,  and  System  Account  Block 


B  .  CPU  2  2 

.BLKW  2 

Total  CPU  time  used 

B . DIR  2 : 

.BLKW  2 

Total  directive  count 

B.QIO: : 

.BLKW  2 

Total  QIO$  count 

B . TAS : : 

.BLKW  2 

Total  task  count  (not  used  in  TAB) 

.BLKW  3 

Reserved 

B . BEG : : 

.BLKW  3 

Beginning/login  time 

B.CPUL: 2 

.BLKW  2 

CPU  time  limit  in  TAB  or  UAB 
(not  used  in  SAB) 

B . PNT : : 

.BLKW  1 

Pointer  to  SAB  if  system  statistics 
to  be  collected.  Equals  0  if  no 
system  statistics  collection.  In  TAB 
this  points  to  UAB.  In  UAB  points  to 

SAB  if  SYSTEM-STATISTICS: YES  or  zero. 

In  SAB  always  zero. 

B . STM : : 

.BLKB  1 

Status  mask 

BS.ACT==200 

Control  block  active  (UAB,  TAB) 

BS.CRH==100 

Record  from  TMP  file  after  crash  (UAB,  SAB 

BS.LGO==40 

Logged  off  with  outstanding 
activities  (UAB  only) 

BS.CO==40 

Tasks  TI:  is  CO:  (TAB  only) 

BS.TML==20 

TAB  exists  only  for  time  limit  (TAB  only) 
TABS  with  this  bit  set  will  not 
be  written  to  the  transaction  file. 

BS . SIL==20 

Silent  login/logout  (UAB  only) 

BS.ZER==10 

Last  CPU  interval  was  zero  length  (TAB,  UAB ' 

BS . SCN==4 

Transaction  ready  for  write  to  scan  (UAB, 
SAB)  file 

User  Account  Block 


Note:  User  Account  Blocks  must  end  on  a  word  boundary. 


B • USE : : 

B . ACT : : 
B.UUIC: : 
B.UCB: : 

B . LGO : : 

B . ULNK : : 
B.RNA:  : 


.BLKB  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  3 
.BLKW  1 
.BLKW  3 


Use  count 

Number  of  currently  active  tasks 
Login  UIC 
Pointer  to  UCB 
Logout  time 

Link  to  next  User  Account  Block 
Location  in  system  account  file  - 
(offset,  VBN-hi,  VBN-lo) 

This  will  be  inaccurate  if  the 
account  file  is  changed  (additions, 
deletions,  sorts) . 


t 
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B . NAM : : 

.  BLKB  14. 

Last  name  of  user 

. BLKB  1 

First  initial  of  user 

.BLKB  1 

Flag  byte  for  UAB  (BS.SIL 

B . LDS : s 

.BLKB  10 

Login  directory  string 

B . ULEN== . 

User  Account  Block  Length 

Task  Account  Block 


NOTE:  Task 

Account  Blocks 

must  end  on  a  word  boundary. 

B.PRI: : 

.BLKB  1 

Highest  running  priority 

B . TNAM : : 

. BLKW  2 

Task  name 

B.TCBs : 

. BLKW  1 

TCB  address 

B.TST3: : 

.BLKW  1 

T.ST3  from  task's  TCB 

.BLKW  1 

Reserved  for  future  status  bits 

B.CUIC: : 

.BLKW  1 

Current  UIC  of  task 

B.PUIC: : 

.BLKW  1 

Protection  UIC  of  task 

B . CTXT : : 

.BLKW  2 

Number  of  context  loads 

B . TCKP : : 

.BLKW  2 

Times  task  has  been  checkpointed 

B.OVLY: : 

.BLKW  2 

Number  of  disk  overlay  loads 

B.EXST: : 

.BLKW  2 

Exit  status  and  abort  code  1 

B . TLEN== . 

TAB  length 

1.  The  abort  codes  are  as  follows: 


S.CACT=-4. 

S.CEXT=-2 . 

S.COAD=0. 

S.CSGF=2. 

S.CBPT=4. 

S.CI0T=6. 

S.CILI=8. 

S.CEMT=10. 

S.CTRP=12. 

S.CFLT=14. 

S.CSST=16. 

S.CAST=18. 

S.CABO=20. 

S.CLRF=22 . 

S.CCRF=24. 

S . IOMG=26 . 

S . PRTY=28 . 

S . CPMD=30 . 

S.CELV=32. 

S.CINS=34. 

S.CAFF=36. 

S.CCSM=38. 
S.COTL=40 . 
S.CTKN=42 


Task  still  active 

Task  exited  normally 

Odd  address  and  traps  to  4 

Segment  fault 

Break  point  or  trace  trap 

IOT  instruction 

Illegal  or  reserved  instruction 
Non-RSX  EMT  instruction 
TRAP  instruction 

PDP-11/40  floating  point  exception 

SST  abort-bad  stack 

AST  abort-bad  stack 

Abort  via  directive 

Task  load  request  failure 

Task  checkpoint  read  failure 

Task  exit  with  outstanding  I/O 

Task  memory  parity  error 

Task  aborted  with  PMD  request 

TI:  virtual  terminal  was  eliminated 

Task  installed  in  2  different  systems 

Task  aborted  due  to  bad  affinity  (required  by  runs  are 
offline  or  not  present) 

Bad  parameters  or  bad  stack 

Task  has  run  over  its  time  limit 

Abort  via  directive  with  no  TKTN  message 
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System  Account  Block 


B . SHDN : : 


B.UHD: 
B . ULO : 
B . ULT : 
B . CKP : 
B . SHF : 
B.RND: 

B . FID: 
B . DVNM 
B . UNIT 
B . EXTS 
B.LSCN 
B.SCNR 
B.DSCN 


B . SLEN== . 


. BLKB  1 


. BLKW  1 
. BLKW  1 
.BLKW  2 
.BLKW  2 
. BLKW  2 
.BLKW  2 

.BLKW  3 
.BLKB  2 
.BLKW  1 
.BLKW  1 
.BLKW  3 
.BLKW  1 
.BLKW  1 

.BLKW  9. 


Accounting  shutdown  reason  code 

1  -  Maintenance 

2  -  Reboot 

3  -  Scheduled  shutdown 

4  -  Accounting  shutdown  by  Shutup 

task 

5  -  Other 

/User  Account  Block  listhead 
x  Number  of  users  currently  logged  on 
Total  number  of  logons 
Total  number  of  checkpoints 
Total  number  of  shuffler  runs 
Number  of  CPU  intervals  rounded  up 
to  1/2 

File-ID  of  transaction  file 
Device  of  transaction  file 
Unit  of  transaction  file 
Extend  size  for  transaction  file 
Time  of  last  scan 
Scan  rate  in  seconds 
Device  statistical  scan  rate  in 
seconds 
Reserved 

System  Account  Block  length 


SYSLOG  Startup  Transaction  Block 


B . SSLN== . 


Transaction  length 


Set  Accounting  Transaction  Block 


B . OF IDs s 
B.ODNM: : 
B . OUNT : : 
B.NFID: : 
B.NDNM: : 
B . NUNT : : 
B . OEXS : : 
B.NEXS: : 
B.OSCR: s 
B.NSCR: : 
B.ODSC: : 
B.NDSC: : 
B . RTLN== 


.BLKW  3 
.BLKB  2 
.BLKW  1 
.BLKW  3 
.BLKB  2 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 


File-ID  of  old  transaction  file 
Device  of  old  transaction  file 
Unit  of  old  transaction  file 
File-ID  of  new  transaction  file 
Device  of  new  transaction  file 
Unit  of  new  transaction  file 
Extend  size  for  old  transaction  file 
Extend  size  for  new  transaction  file 
Old  scan  rate  in  seconds 
New  scan  rate  in  seconds 
Old  statistical  scan  rate 
New  statistical  scan  rate 
Transaction  length 


Crash  Recovery  Transaction  Block 


B.CTLS: : 
B.CSRTs  s 
B.CRSN: : 
B . CLEN== 


BLKW  3 
BLKW  1 
BLKB  60 


Time  of  last  scan  before  crash 
Scan  rate  before  crash 
ASCII  text  explaining  crash 
Transaction  length 
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Invalid  Login  Transaction  Block 


B.INAM: : 

. BLKB  14. 

Name  from  login  line 

B.IUIC: : 

. BLKB  6. 

UIC  from  login  line 

B.IPSW: : 

.BLKB  6. 

Password  from  login  line 

B . ILEN== . 

Transaction  length 

Device  Transaction  for  Disk  Accounting 

(ALLOCATE,  DEALLOCATE,  MOUNT,  and  DISMOUNT) 

B . DNAM : : 

. BLKW  1 

ASCII  device  name 

B . DUNT : : 

.BLKB  1 

Octal  device  unit  number 

B . DLEN== . 

Transaction  length  for  ALLOCATE, 

DISMOUNT,  and  DEALLOCATE 

The  following 

fields  only  appear  for  MOUNT  transactions 

.BLKB  1 

Unused  byte 

B . DLBL : : 

.BLKW  6 

Volume  label 

B . DMST : : 

.BLKW  1 

Mount  Status  Bits 

B.DUIC: : 

.BLKW  1 

Owner  UIC 

B.DVPR: : 

.BLKW  1 

Volume  protection  code  ^ 

B . DACP : 2 

.BLKW  2 

Name  of  ACP  for  device 

B . MLEN== . 

Length  of  MOUNT  transactions 

System  Time 

Change  Transaction  Block 

B . TOLD : : 

.BLKB  6 

Old  time  (yr,  mon,  day,  hr,  min. 

B . TNEW : s 

.BLKB  6 

New  time  (yr,  mon,  day,  hr,  min. 

B . TMLN== . 

Transaction  length 

2 .  The  volume 

protection  codes  are  as  follows: 

Bits 

Protection 

0-3 

system 

4-7 

owner 

8-11 

group 

12-15 

world 

The  bit  settings  within  each 

protection  group  are  as  follows: 

Bit  Access  denied  (if  bit  set) 

0 

read 

1 

write 

2 

create 

3 

delete 
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Print  Despooler  Transaction  Block 


B.PNAM 
B.PPGS 
B.PNFI 
B . PFRM 
B.PPRI 
B . PDEV 
B . PPUN 
B .  PLEN: 


. BLKW  3 
. BLKW  1 
.BLKW  1 
. BLKB  1 
. BLKB  1 
.BLKW  1 
.BLKB  1 


Print  job  name  (RAD50) 

Page  count 

Number  of  files  printed 
Form  number 
Print  priority 
Print  device  name  (ASCII) 
Unit  number  of  print  device 
Transaction  length 


Card  Reader  Spooling  Transaction  Block 


B.RNAM: : 

.BLKW 

3 

Batch  or  print  job  name 

B . RCDS : : 

.BLKW 

1 

Number  of  cards  read 

B . RDEV : : 

.BLKW 

1 

Reader  device  name  (ASCII) 

B . RUNT : : 

.BLKB 

1 

Unit  number  of  reader  device 

B . RSOP : : 

.BLKB 

1 

Submit  or  print  (0=SUBMIT#  1=PRINT) 

B . RLEN== . 

Transaction  length 

Login  Transaction  Block 


B.LUIC: : 
B . LNAM s : 


B . LLEN== . 


.BLKW  1 
.BLKB  14. 
.BLKB  1 


Login  UIC 
User's  last  name? 
User's  first  initial 
Transaction  length 


The  following  globals  are  also  defined: 


B . MAXL== 128. 
B.MINL==9. 


Maximum  transaction  length  (words) 
Minimum  transaction  length  (words) 


Device  Statistics  Block 


X . NAME : : 
X . IOC : : 

X . ERHL : : 
X.ERSL: : 
X.ERSC: : 
X . ERHC : : 
X.WCNT: : 
X . CYLC : : 
X . CCYL : : 
X.FCUR: : 
X.FLIM: : 
X.DSKD: : 
X.DNAM: : 
X . UNIT : : 


BLKW 

2 

Drive  name  in  RAD50 

BLKW 

2 

I/O  Count 

BLKB 

1 

Hard  error  limit 

BLKB 

1 

Soft  error  limit 

BLKB 

1 

Soft  error  count 

BLKB 

1 

Hard  error  count 

BLKW 

2 

Words  transferred  count 

BLKW 

2 

Cylinders  crossed  count 

BLKW 

1 

Current  cylinder 

BLKB 

1 

Current  fairness  count 

Fairness  count  limit 

BLKB 

1 

Disk  direction  (high  bit  l=out) 

BLKB 

1 

Device  name  for  accounting 

BLKB 

1 

Unit  number  for  accounting 

BLKB 

1 

Unused 

X . LGTH== . 


Length  of  the  UCB  extension 
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17.6.3  Account  Block  Linkages 


Figure  17-2  Account  Block  Linkages 
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O  Terminal  TT5 : ,  which  is  indicated  by  the  UCB,  is  that  of  the 
most  recently  logged-in  user.  The  user  of  this  terminal  has 
started  two  tasks,  which  are  indicated  by  the  two  Task 
Control  Blocks  (TCB )  that  contain  pointers  to  the  UCB 
(T.UCB)  and  each  associated  TAB  (T.ACN).  Each  TAB  then 
points  to  the  terminal's  UAB.  The  total  usage  of  terminal 
TT5 :  is  totaled  in  the  associated  UAB. 

©  Terminal  TT7 :  is  that  of  the  next  most  recently  logged-in 
user.  The  user  has  started  a  task  indicated  by  the  single 
TCB,  which  points  to  a  TAB  which  points  to  a  UAB.  The  total 
usage  of  terminal  TT7 :  is  totaled  in  the  associated  UAB. 

©  The  CO:  console  terminal  has  associated  with  it  a  single 
TCB  that  indicates  a  system  task  is  running.  In  effect,  the 
system  is  also  a  user  and  has  system  usage  accumulated  at 
the  task  level  in  the  TAB  and  totaled  in  the  UAB  associated 
with  the  CO:  terminal. 

©  The  SAB  contains  the  usage  totals  for  all  the  users 
including  the  system  itself.  The  B.UHD  pointer  in  the  SAB 
points  to  the  UAB  of  the  most  recently  logged-in  user. 
B.UHD  and  the  B.ULNK  words  in  each  UAB  are  the  linkages  that 
are  used  when  Accounting  periodically  writes  the  UABs  to  the 
scan  file. 

©  The  pointer  to  the  SAB  ($SABPT)  is  in  the  Executive  module 
SYSCM . 

©  The  pointer  to  the  system  UAB  ($SYUAB)  is  in  the  Executive 
module  SYSCM. 

NOTE 

Although  all  active  UCBs  point  to  the  appropriate 
UABs  using  U.UAB,  this  is  not  true  for  CO:.  U.UAB 
does  not  exist  for  CO:,  but  instead  is  reflected  by 
location  $SYUAB. 


17.7  SYSTEM  RESOURCES  USED 

The  following  sections  discuss  the  amount  of  system  space  that 
Resource  Accounting  uses.  Secondary  pool  usage  varies  from  a  certain 
minimum  to  an  amount  determined  by  the  number  of  logged- in  users  and 
event-associated  transactions. 


17.7.1  Executive  Space  Requirements 

Accounting  support,  which  is  a  SYSGEN  option,  takes  up  approximately 
532  words.  Space  in  system  pool  is  required  for  one  active  task  and 
one  open  file. 


17.7.2  Secondary  Pool  Usage 

Each  logged-in  user  requires  two  blocks  (32  words  per  block)  of 
secondary  pool  for  the  User  Account  Block  (UAB)?  that  is,  two  blocks 
for  each  logged- in  terminal  or  virtual  terminal.  Each  task  running  in 
the  system  requires  two  blocks  for  the  Task  Account  Block  (TAB),  if 
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task  accounting  is  enabled.  Resource  Accounting  needs  two  blocks  for 
the  SAB  and  two  blocks  for  the  system  UAB .  Non-memory-resident 
events,  such  as  device  mounts,  require  one  block  for  a  brief  period  of 
time . 


17.8  RESOURCE  ACCOUNTING  MESSAGES 

Accounting  messages  are  numbered  from  1(10)  through  79(10).  However, 
not  all  of  the  numbers  in  this  range  are  used.  The  number  appears  at 
the  start  of  the  Accounting  message.  The  Accounting  messages  have  the 
following  format: 

hh:mm:ss  aaaTnn  nn .  *aaaaaa*  message... 
where : 
hh :mm: ss 

The  time  of  the  message  occurrence  is  hh:mm:ss 


aaaTnn 

The  task  issuing  the  message  and  the  terminal  executing  the  task 
are  displayed  as  aaaTnn.  The  first  three  letters  of  the  task 
name  are  indicated  by  aaa .  Tnn  is  the  terminal  number  of  the 
terminal  executing  the  task.  SYSLOG  appears  if  the  message 
originated  from  that  task. 


nn . 

The  message  number  is  nn .  The  message  number  enables  you  to  find 
a  description  of  the  message  in  the  following  list  of  messages. 


*aaaaaa* 

The  message  severity  code  is  aaaaaa  and  it  has  four  forms •  It 
may  not  be  present;  if  it  is  not,  the  message  is  an  informational 
message.  The  four  forms  of  the  severity  code  are  as  follows: 

*DIAG*  -  Information  only 

*WARN*  -  Possible  error  condition 

* ERROR*  -  Command  did  not  succeed 

* FATAL*  -  Extreme  error  condition 

The  following  is  a  list  of  the  Accounting  messages: 


nn : nn : nn  aaaTnn  1.  Undefined  message  number  nn . t  at  PC  aaaaaa 

Explanation:  The  message  number  is  a  decimal  number  specified  by 

nn .  The  location  is  specified  by  the  address  aaaaaa.  This  is  an 
internal  Accounting  error. 

User  Action:  Submit  a  Software  Performance  Report  (SPR) . 
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nn : nn : nn  aaaTnn  2.  Directive  error.  $DSW=nnn  PC  is  just  before  aaaaaa 

Explanation:  The  directive  error  code  is  an  octal  number 

specified  by  nnn .  The  PC  contains  an  address  just  preceding  the 
octal  address  aaaaaa.  This  message  provides  additional 
information  to  a  message  that  will  appear  with  it. 

User  Action:  Look  up  the  directive  error  code  in  the 
RSX-1 1M- PLUS  Mini-Reference  to  obtain  more  information. 


nn :nn :nn  aaaTnn  4.  FCS  aaa  ERROR  CODE  =  nnn 
FILE:  DBn:  [???,???] filename . filetype ; v 

Explanation:  The  word  "I/O"  or  "DSW"  is  specified  by  aaa.  The 

error  code  is  specified  by  nnn.  The  UIC  is  inaccessible  and 
appears  as  question  marks. 

User  Action:  Refer  to  the  RSX-1 1M-PLUS  Mini-Reference  for  an 
explanation  of  the  error  code. 


nn :nn :nn  aaaTnn  5.  *ERROR*  Illegal  filename 

Explanation:  The  file  name  specified  in  the  START /ACCOUNTING 

command  is  invalid. 

User  Action:  Correct  the  file  name  and  reenter  the  command. 
nn:nn:nn  aaaTnn  6.  * FATAL*  Can't  open  transaction  file 


[message] 

Explanation:  The  transaction  file  could  not  be  created  for  the 

reason  specified  in  the  message  that  follows  "Can't  open 
transaction  file . " 

User  Action:  Determine  the  cause  of  the  error  and  correct  it. 


nn:nn :nn  aaaTnn  7.  * FATAL*  Can't  open  transaction  file  (by  id) 


[message] 

Explanation:  After  it  was  created,  the  transaction  file  became 

inaccessible  for  reason  specified  in  the  message  that  follows 
"Can't  open  transaction  file  (by  id)." 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 
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nnsnnsnn  aaaTnn  8.  * FATAL*  Can't  write  transaction  file 


[message] 

Explanation:  The  transaction  file  could  not  be  written  for  the 
reason  specified  in  the  message  that  follows  "Can't  write 
transaction  file."  Accounting  cannot  recover  from  this  error. 
Accounting  data  is  lost  because  the  file  cannot  be  written. 

User  Actions  Issue  STOP/ACCOUNTING  CLEAN_UP ,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 

nn:nn:nn  aaaTnn  9.  *ERROR*  Can't  close  transaction  file 

Explanation:  The  transaction  file  could  not  be  closed. 
Acounting  cannot  recover  from  this  error .  Accounting  data  is 
lost  because  the  file  cannot  be  closed. 

User  Action:  If  possible,  determine  why  the  file  cannot  be 
closed.  Restart  Accounting  for  a  short  period  to  see  if  the 
error  recurs . 


nn:nn:nn  aaaTnn  10.  * FATAL*  Can’t  init  new  blocks 

Explanation:  The  transaction  file  cannot  be  written  when  the 

file  is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  is  lost  because  the  file  cannot  be 
written  to  be  extended . 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP ,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 


nn : nn : nn  aaaTnn  11.  * FATAL*  Can't  init  new  blocks.  I/O  error  =  nnn 

Explanation:  The  transaction  file  cannot  be  written  when  the 

file  is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  is  lost  because  the  file  cannot  be 
written  to  be  extended. 

User  Action:  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 

An  explanation  of  the  I/O  error  code  can  be  found  in  either  the 
RSX-11M  Mini-Ref erence  or  the  RSX-11M-PLUS  Mini-Reference. 

nn : nn : nn  aaaTnn  12.  *FATAL*  Can't  write  attributes.  I/O  error  =  nnn 

Explanation:  The  transaction  file  cannot  be  written  when  the 

file  is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  is  lost  because  the  file  cannot  be 
written  to  be  extended. 

User  Action:  Issue  STOP /ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 

An  explanation  of  the  I/O  error  code  can  be  found  in  the 
RSX-11M/M-PLUS  Mini-Reference. 
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nn:nn:nn  aaaTnn  13.  *FATAL*  Can't  write  attributes 

Explanations  The  transaction  file  cannot  be  written  when  the 
file  is  being  extended.  Accounting  cannot  recover  from  this 
error.  Accounting  data  is  lost  because  the  file  cannot  be 
written  to  be  extended . 

User  Action:  Issue  STOP /ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 


nnsnnsnn  aaaTnn  14.  *FATAL*  Secondary  pool  allocation  failure 

Explanation:  There  is  insufficient  secondary  pool  remaining  to 

start  Accounting . 

User  Action:  Use  VMR  (Chapter  10)  to  increase  the  secondary  pool 
partition  size,  and  rebootstrap. 


nn:nn:nn  aaaTnn  15.  * FATAL*  Bad  SYSLOG  queue 

Explanation:  The  SYSLOG  task's  input  is  not  empty  during 
Accounting  startup. 

User  Action:  Issue  STOP /ACCOUNTING  CLEAN_UP  and  restart 

Accounting . 


nn:nn:nn  aaaTnn  16.  *ERR0R*  Accounting  already  active 
Explanation:  Accounting  is  already  active. 

User  Action:  None. 


nn:nn:nn  aaaTnn  17.  * FATAL*  Error  spawning  SYSLOG 


[message] 

Explanation:  The  SYSLOG  task  could  not  be  started  due  to  the 

reason  specified  in  the  message  that  follows  "Error  spawning 
SYSLOG . " 

User  Action:  Determine  the  cause  of  the  error,  correct  it,  and 
restart  Accounting. 


nn:nn:nn  aaaTnn  18.  Accounting  system  not  started 


[message] 

Explanation:  Accounting  was  not  started  because  of  the  reason 

specified  in  the  message  that  follows  "Accounting  system  not 
started . " 

User  Action:  Determine  the  cause  of  the  error,  correct  it,  and 
restart  Accounting. 
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nn : nn : nn  aaaTnn  21.  SYSLOG  exit  with  status  =  n. 


[message] 

Explanations  The  exit  status  of  the  SYSLOG  task  is  represented 
by  the  decimal  number  n.  See  the  accompanying  SYSLOG  message. 

User  Actions  Correct  the  problem,  if  there  is  one,  and  try 
again . 


nnsnnsnn  aaaTnn  22.  *ERROR*  SYSLOG  not  installed 

Explanations  The  SYSLOG  task  was  not  installed  when 

START/ ACCOUNTING  was  specified. 

User  Actions  Install  SYSLOG  and  reissue  the  START /ACCOUNTING 
command . 


nnsnnsnn  aaaTnn  23.  *ERROR*  Error  bit  set.  Cleanup  before  restart. 

Explanations  Accounting  had  an  error  and  cannot  be  restarted 
until  you  issue  the  STOP /ACCOUNTING  CLEAN_UP  command. 

User  Actions  Issue  the  STOP/ACCOUNTING  CLEAN _UP  command  and 
restart  Accounting. 


nnsnnsnn  aaaTnn  25.  *ERROR*  Accounting  did  not  crash 

Explanations  A  STOP/ACCOUNTING  CLEAN_UP  command  was  issued 
unnecessarily. 

User  Actions  None. 


nnsnnsnn  aaaTnn  27.  * FATAL*  System  command  handling  error 

Explanations  This  is  a  Get  MCR  command  line  directive  failure. 

User  Actions  None.  The  ACC  task  was  RUN,  so  no  command  line  was 
queued.  Access  to  this  task  is  only  legal  with  the  specified 
Accounting  commands . 


nnsnnsnn  aaaTnn  28.  *ERROR*  Privilege  violation 

Explanations  You  did  not  have  the  privilege  for  the  specified 
operation . 

User  Actions  None.  Nonprivileged  users  can  see  the  Accounting 
data  for  their  terminal  only. 


nnsnnsnn  aaaTnn  29.  *ERROR*  Accounting  not  supported  in  system 

Explanations  Accounting  cannot  be  used  unless  it  is  selected  as 
an  option  in  SYSGEN . 

User  Actions  Do  another  SYSGEN  and  select  Accounting  as  an 
option. 
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nn:nn:nn  aaaTnn  30.  *ERROR*  Illegal  command  or  parameter 
Explanation:  The  entered  command  is  incorrect. 

User  Action:  Enter  the  correct  command. 

nn:nn:nn  aaaTnn  31.  *ERROR*  Command  or  parameter  ambiguous 

Explanation:  Parameter  was  entered  with  too  few  letters  to  be 

uniquely  identified. 

User  Action:  Reenter  the  command  with  more  letters  in  the 
parameter . 

nn:nn:nn  aaaTnn  32.  * ERROR*  Syntax  error 

Explanation:  The  entered  command  is  incorrect. 

User  Action:  Enter  the  correct  command. 

nn:nn:nn  aaaTnn  33.  *ERR0R*  Terminal  I/O  error 

Explanation:  A  terminal  I/O  error  occurred  during  a  prompt  or  a 

read  to  the  terminal. 

User  Action:  Try  the  operation  again. 

nn:nn:nn  aaaTnn  34.  *ERR0R*  Repeated  or  contradictory  parameter 
Explanation:  Illegal  or  duplicate  parameter  combination. 

User  Action:  Enter  the  correct  command  parameter. 

nn:nn:nn  aaaTnn  35.  *ERR0R*  Required  parameter  missing 

Explanation:  A  parameter  is  missing  in  the  command  line. 

User  Action:  Reenter  the  command  with  the  required  parameter. 

nn : nn : nn  aaaTnn  36.  *ERR0R*  Value  out  of  range 

Explanation:  The  value  entered  was  either  too  large  or  too 

small . 

User  Action:  Reenter  the  command  with  the  correct  value. 

nn:nn:nn  aaaTnn  38.  *ERR0R*  No  accounting  data  present 

Explanation:  The  terminal  specified  in  the  SHOW  ACCOUNTING/- 

INFORMATION  command  either  does  not  have  any  Accounting  data  or 
is  not  logged  in. 

User  Action:  Determine  the  correct  terminal  to  use  and  reenter 
the  command . 
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nn : nn : nn  aaaTnn  39.  *ERROR*  Device  specification  error 

Explanations  A  device  specification  was  entered  incorrectly  in 
the  command  line. 

User  Actions  Determine  the  correct  device  and  reenter  the 
command . 


nnsnnsnn  aaaTnn  40.  *  FATAL  *  No  startup  transaction  found 

Explanations  The  START/ACCOUNTING  command  and  the  SYSLOG  task 
are  closely  related  and  depend  on  each  other  for  correct 
operation.  Any  attempt  to  start  the  SYSLOG  Accounting  task  by 
any  method  other  than  the  use  of  START/ACCOUNTING  results  in  this 
message . 

User  Actions  If  START /ACCOUNTING  and  SYSLOG  were  used  as 
intended  and  this  error  resulted,  submit  an  SPR. 


nnsnnsnn  aaaTnn  41.  *WARN*  Bad  transaction  length.  Block(s)  of  secondary 

pool  may  be  lost 

Explanations  A  transaction  was  probably  too  large  or  too  small 
and  is  probably  a  user-designed  transaction. 

User  Actions  Correct  the  generation  of  the  transaction.  See 
B.MINL  or  B.MAXL  in  Section  17.6.2. 

nnsnnsnn  aaaTnn  42.  *ERR0R*  UAB  Listhead  not  zero  on  shutdown 
Explanations  Internal  consistency  error. 

User  Actions  Submit  an  SPR. 


nnsnnsnn  aaaTnn  43.  *ERR0R*  Transactions  follow  SAB 
Explanations  Internal  consistency  error. 

User  Actions  Submit  an  SPR. 

nnsnnsnn  aaaTnn  44.  * FATAL*  UAB  Not  found  in  list 

Explanations  Internal  consistency  error. 

User  Actions  Submit  an  SPR. 


nnsnnsnn  aaaTnn  45.  * FATAL*  Exiting  due  to  error 

Explanations  SYSLOG  exited  for  the  specified  reason.  The 
specified  reason  is  in  the  message  that  appears  with  this  one. 

User  Actions  Issue  STOP/ACCOUNTING  CLEAN_UP,  determine  the  cause 
of  the  error,  correct  it,  and  restart  Accounting. 


nnsnnsnn  aaaTnn  46.  * FATAL*  Transaction  not  in  secondary  pool 

Explanations  Internal  consistency  error. 

User  Actions  Submit  an  SPR. 
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nn :nn :nn  aaaTnn  47.  Exiting 

Explanations  Normal  SYSLOG  exit  due  to  STOP /ACCOUNTING  command. 
User  Actions  None. 

nnsnnsnn  aaaTnn  50.  Accounting  not  active 

Explanations  The  command  issued  requires  Accounting  to  be 
running . 

User  Actions  Issue  START /ACCOUNTING  and  reissue  the  command. 

nnsnnsnn  aaaTnn  51.  *ERROR*  Accounting  had  a  fatal  error,  must  be 

cleaned  up 

Explanations  Accounting  failed. 

User  Actions  Issue  the  STOP/ACCOUNTING  CLEAN_UP  command. 

nnsnnsnn  aaaTnn  52.  * ERROR*  SYSLOG  Not  active 

Explanations  SYSLOG  has  unexpectedly  exited. 

User  Actions  Issue  the  STOP/ACCOUNTING  CLEAN  UP  command  and 
restart  Accounting.  “ 

nnsnnsnn  aaaTnn  53.  *ERROR*  Cannot  write  crash  transaction 


[message] 

^'xP^-an®^-ion  s  The  crash  transaction  could  not  be  written  to  the 

new  transaction  file  for  the  specified  reason  following  "Cannot 
write  crash  transaction."  The  crash  data  is  lost. 

User  Actions  None. 

nnsnnsnn  aaaTnn  54.  *ERROR*  Error  during  scan  file  rename 

Explanations  The  specified  error  was  encountered  when  dealinq 

with  the  scan  file.  y 

User  Actions  Determine  the  cause  of  the  problem  and  correct  it. 

nnsnnsnn  aaaTnn  55.  *ERROR*  On  scan  file  PUT? 

Explanations  The  specified  error  was  encountered  when  dealinq 

with  the  scan  file.  y 

User  Actions  Determine  the  cause  of  the  problem  and  correct  it. 
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nn:nn: nn  aaaTnn  57.  Enter  reason  for  the  crash  (Maximum  60.  characters) 


Explanations  This  is  the  prompt  for 
reason  because  "yes"  was  answered  as 
on  the  START/ACCOUNTING  command. 


the  user-supplied  crash 
the  CRASH  REASON  parameter 


User  Actions  Enter  a  crash  reason. 


nnsnnsnn  aaaTnn  58.  *ERR0R*  Terminal  I/O  Error 

Explanations  An  I/O  error  occurred  from  the  terminal  during  the 
input  of  the  crash  information.  The  crash  information  is  lost. 

User  Actions  None. 


nnsnnsnn  aaaTnn  60.  *ERR0R*  I/O  Error 

Explanations  The  specified  I/O  error  occurred 
ACCOUNTING  TRANSACTION  command. 

User  Actions  Correct  the  I/O  condition  and 
again. 


during  the  SHOW 


try  the  command 


nnsnnsnn  aaaTnn  64.  *ERR0R*  Illegal  file  name 

Explanations  There  is  an  incorrect  file  specification 
SHOW  ACCOUNTING  TRANSACTION  command. 

User  Actions  Correct  the  file  specification  and  try  the 
again . 


for  the 

command 


nnsnnsnn  aaaTnn  65.  *ERR0R*  Open  error 

Explanations  The  specified  error  occurred  during  a  file  open 
procedure  of  the  SHOW  ACCOUNT I NG/ TRANSACT I ON_FILE  command. 

User  Actions  Determine  the  cause  of  the  error,  correct  it,  and 
try  the  operation  again. 

nnsnnsnn  aaaTnn  70.  *ERROR*  On  scan  file  open 

Explanations  The  specified  error  was  encountered  when  Accounting 
was  processing  the  scan  file. 

User  Actions  Determine  the  cause  of  the  problem  and  correct  it. 


nnsnnsnn  aaaTnn  71.  * ERROR*  On  scan  file  delete 


Explanations  The  specified  error  was  encountered  when  Accounting 
was  processing  the  scan  file. 


User  Actions  Determine  the  cause  of  the  problem  and  correct  it. 
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nn:nn:nn  aaaTnn  72.  *ERROR*  On  scan  file  close 

Explanations  The  specified  error  was  encountered  when  Accounting 
was  processing  the  scan  file. 

User  Action:  Determine  the  cause  of  the  problem  and  correct  it. 

nnsnnsnn  aaaTnn  73.  * ERROR*  On  scan  file  open 

Explanations  The  specified  error  was  encountered  when  processing 
the  scan  file. 

User  Actions  Determine  the  cause  of  the  problem  and  correct  it. 

nn:nn:nn  aaaTnn  74.  * ERROR*  Copying  scan  file  to  trans  file 

Explanations  The  specified  error  was  encountered  when  processing 
the  scan  file.  The  crash  information  that  would  have  appeared  in 
the  transaction  file  is  lost. 

User  Actions  None. 

nnsnnsnn  aaaTnn  75.  *ERROR*  On  scan  file  close 

Explanations  The  specified  error  was  encountered  when  processing 
the  scan  file. 

User  Actions  Determine  the  cause  of  the  problem  and  correct  it. 

nnsnnsnn  aaaTnn  76.  *ERROR*  On  scan  file  delete 

Explanations  The  specified  error  was  encountered  when  processing 
the  scan  file. 

User  Actions  Determine  the  cause  of  the  problem  and  correct  it. 

nnsnnsnn  aaaTnn  79.  *ERROR*  Task  not  in  memory  or  not  active 

Explanations  The  task  specified  with  the  SHOW 

ACCOUNTING/INFORMATION  TASK=taskname  command  was  not  in  memory  or 
was  not  active.  Therefore,  there  is  no  task  accounting  date  for 
this  task. 

User  Actions  None. 
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RSX-11M-PLUS  SHADOW  RECORDING 


Shadow  Recording  (which  is  a  system  generation  option)  is  an  Executive 
feature  of  RSX-11M-PLUS  that  allows  your  system  to  back  up  all  new 
data  as  it  is  written  to  a  Files— 11  disk.  This  chapter  describes 
Shadow  Recording ,  how  to  prepare  your  system  for  it,  and  how  to 
control  it.  There  is  also  a  discussion  of  bad  block  handling  and  a 
list  of  error  messages. 


Shadow  Recording  creates  two  identical  sets  of  disks  called  a 
"shadowed"  pair.  More  than  one  pair  of  disks  may  be  shadowed,  but 
shadowed  disk  pairs  cannot  overlap.  The  first  disk  of  the  pair,  the 
primary  disk,  is  the  original  disk  that  exists  whether  or  not  Shadow 
Recording  is  active.  You  can  make  any  disk  on  your  system,  including 
the  system  disk,  the  primary  disk  of  a  shadowed  pair.  By  using  the 
preparatory  procedure  described  in  Section  18.1  and  the  START  command 
described  in  Section  18.2,  the  second  disk  of  the  pair  (the  secondary 
disk)  becomes  an  exact  copy  of  the  primary  disk. 


The  START  command  invokes  a  Shadow  Recording  task  called  SHAddn  (or 
SHddnn) ,  where  ddnn  is  the  device  unit  of  the  primary  disk.  This  task 

is  the  "catchup"  task  that  copies  the  primary  disk  to  the  secondary 

disk.  Shadow  Recording  occurs  while  catchup  is  in  progress.  In  other 
words,  records  are  written  to  both  the  primary  disk  and  secondary 
disk,  without  interfering  with  the  catchup  process. 

After  you  issue  the  START  command.  Shadow  Recording  provides  a  dynamic 
backup  of  all  blocks  as  they  are  written  to  the  primary  disk.  Shadow 
Recording  has  important  uses  in  the  following  applications: 

•  Duplicating  important  information  to  prevent  inadvertent 

damage  or  loss.  With  Shadow  Recording,  critical  data  is 

duplicated  on  two  disks.  This  redundancy  prevents  loss  of 

data  if  a  disk  error  occurs  and,  therefore,  may  provide 

quicker  recovery  time  in  critical  applications.  Also, 

downtime  may  be  reduced  because  disk  errors  do  not  necessarily 
mean  an  application  must  be  halted. 

•  Providing  on-line  backup  to  give  an  "instant"  duplicate  disk 
where  later  backup  time  or  resources  are  unavailable. 

The  Shadow  Recording  feature  operates  transparently  because  writing  to 
and  reading  from  the  secondary  disk  is  an  Executive  function.  The 
Executive  always  writes  the  same  data  to  the  secondary  disk  that  it 

writes  to  the  primary  disk  when  Shadow  Recording  is  active.  However, 

when  a  disk  read  occurs,  the  Executive  reads  the  primary  disk  first. 
If  a  read  error  occurs  on  the  primary  disk,  the  Executive  reads  the 
secondary  disk.  The  Executive  displays  all  I/O  errors  occurring  on  a 
Shadow  Recording  disk  pair  on  the  operator's  console. 
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Now  that  you  are  generally  familiar  with  Shadow  Recording,  proceed 
first  to  Section  18.1  to  prepare  your  system,  and  then  to  Section  18.2 
to  learn  how  to  control  Shadow  Recording,  beginning  with  the  START 
command.  START  is  one  of  fiye  commands  you  can  use  to  control  Shadow 
Recording.  Note,  however,  that  you  can  enter  these  commands  only  from 
a  privileged  terminal . 

If  you  encounter  errors  during  any  of  the  Shadow  Recording  procedures, 
refer  to  Sections  18.3  and  18.4. 


18.1  PREPARING  YOUR  SYSTEM  FOR  SHADOW  RECORDING 

More  than  one  pair  of  disks  can  be  shadowed,  but  shadowed  pairs  cannot 
overlap.  For  example,  if  you  make  DBO :  and  DB1 :  a  shadowed  pair, 
you  can  make  DB2:  and  DB3 :  a  shadowed  pair  but  not  DB1:  and  DB2 ; . 

Additionally,  the  devices  must  be  of  the  same  type. 

Before  you  can  use  a  pair, of  disk  drives  for  Shadow  Recording,  you 
must  have  available  two  identical  disk  packs.  The  two  disk  packs  must 
have  the  same  bad  block  data.  You  can  make  the  bad  block  data  on  the 
two  disks  functionally  equivalent  by  following  the  procedures 
discussed  next. 

In  the  following  procedure,  the  assumption  is  made  that  you  will 
shadow  record  the  system  disk.  However,  the  procedure  is  valid  for 
any  two  devices  of  the  same  type .  To  get  ready  for  Shadow  Recording , 
you  must  perform  the  following  actions  for  each  shadowed  pairs 

1.  You  must  select  Shadow  Recording  as  an  option  during  system 
generation  before  you  can  run  Shadow  Recording. 

2 .  Determine  which  two  device  units  you  want  to  use  for  the 
shadowed  pair.  They  must  be  the  same  type  of  device,  for 
example,  two  RP06s  or  two  RM02s.  One  of  these  two  devices 
will  be  the  device  that  will  contain  the  primary  disk  that 
you  want  to  be  "shadowed."  The  other  will  contain  the 
secondary  disk. 

If,  for  example,  your  system  has  four  RP06s  and  you  decide  to 
shadow  record  the  system  device,  DBO s ,  you  can  select  one  of 
the  three  remaining  devices  as  the  secondary  device  of  the 
shadowed  pair:  DB1 : ,  DB2 : ,  or  DB3 : . 

3.  Next,  gather  a  set  (three  or  more)  of  disks  that  you  can  use 
for  Shadow  Recording.  There  are  two  principles  involved  with 
the  selection  of  the  set  of  disks  for  Shadow  Recording: 

•  The  disks  being  used  for  Shadow  Recording  must  be 
logically  equivalent  (have  the  same  bad  blocks).  To  make 
the  disks  logically  equivalent,  you  select  one  disk  of  the 
set  as  the  primary  disk  and  make  its  bad  block  descriptor 
block  a  logical  OR  of  all  the  bad  blocks  in  the  set  of 
disks.  Then,  when  you  start  Shadow  Recording,  the 
contents  of  the  primary  disk,  including  the  bad  block 
information,  are  copied  to  the  secondary  disk. 
Subsequently,  the  Executive  writes  the  same  data  to  the 
secondary  disk  that  it  writes  to  the  primary  disk. 
Because  the  bad  block  information  on  the  primary  disk  is 
an  OR  of  its  own  bad  blocks  and  those  of  the  secondary 
disk,  the  write  to  the  secondary  disk  does  not  occur  for  a 
defective  block. 
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You  can  make  the  disks  logically  identical  by  making 
entries  in  the  bad  block  descriptor  block  of  the  primary 
disk  (see  step  4). 

•  You  can  use  another  disk  of  the  set  as  a  spare,  logically 
equivalent  disk  in  case  of  disk  errors.  This  is  why  you 
should  have  selected  three  or  more  disks  for  your  set  of 
Shadow  Recording  disks.  Using  one  of  these  spare  disks 
enables  quick  recovery  from  possible  disk  errors  and 
decreases  downtime  in  critical  applications.  Error 
recovery  is  discussed  in  Section  18.3. 


4.  Before  you  make  entries  in  the  bad  block  descriptor  block  of 
the  primary  disk,  run  the  Bad  Block  Utility  (BAD)  with  the 
/LI  switch  on  all  the  disks  in  the  set  of  Shadow  Recording 
disks.  BAD  locates  the  bad  blocks  and  lists  them  on  your 
terminal.  This  list  includes  the  information  you  need  to 
make  the  bad  block  descriptor  block  on  the  primary  disk  the 
logical  OR  of  all  the  bad  blocks. 

Now,  you  can  make  entries  in  the  bad  block  descriptor  block 
of  the  primary  disk  by  using  the  INITVOLUME  command  with  the 
/BAD=[MAN]  keyword,  as  follows: 

> INI  ddnn : / BAD= [ MAN ] 

After  you  enter  the  INITVOLUME  command,  the  following  prompt 
is  displayed: 

INI >LBN ( S )= 

In  response  to  this  prompt,  you  can  then  type  from  the 
terminal  the  list  of  bad  blocks.  (The  INITVOLUME  command  is 
described  in  greater  detail  in  the  RSX-1 1M/M- PLUS  MCR 

Operations  Manual . )  Also,  this  bad  block  information  will  be 
used  by  subsequent  INI,  DSC,  or  BRU  operations  on  this 

volume.  The  Disk  Save  and  Compare  Utility  (DSC)  and  the 
Backup  and  Restore  Utility  (BRU)  are  described  in  the 
RSX-1 1M/ M-PLUS  Utilities  Manual . 

5.  Copy  the  data  from  your  system  disk  to  your  primary  disk. 

This  disk  becomes  the  primary  disk  and  your  new  system  disk 

for  Shadow  Recording . 

For  example,  if  you  want  to  shadow  record  your  system  disk, 
copy  it  to  the  primary  disk.  After  this  is  done,  you  will 
have  two  system  disks  with  identical  data,  but  they  will  not 
be  identical  physically  because  of  the  bad  block  locations. 
The  new  system  disk  becomes  the  primary  disk  for  shadow 
recording . 

6.  Mount  as  foreign  one  of  the  previously  selected  disks  on  the 
secondary  device.  Use  the  following  MOUNT  command: 

>  MOUNT  ddnn : / FOR 

Now  you  are  ready  to  use  Shadow  Recording,  beginning  with  the  START 
command  (see  Section  18.2). 
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18.2  CONTROLLING  SHADOW  RECORDING 

You  can  use  five  commands  to  control  Shadow  Recording.  The  commands 
allow  you  to  start,  stop,  abort,  or  continue  Shadow  Recording  and  to 
display  all  device  pairs  that  are  being  "shadowed."  The  five  commands 
are: 

1 .  START 

2 .  STOP 

3 .  ABORT 

4.  CONTINUE 

5.  DISPLAY 

Note,  however,  that  you  can  only  enter  these  commands  from  a 
privileged  terminal.  You  may  enter  these  commands  on  one  line,  for 
example : 

>  SHAdow  START 

Or,  you  may  enter  the  commands  on  two  lines,  for  example: 

>  SHA 

SHA>  START 

The  following  sections  describe  the  commands. 
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START 


18.2.1  START  Command 
The  START  command : 

•  Verifies  that  the  primary  disk  is  a  Files-11  device  and  is 
mounted 

•  Verifies  that  the  secondary  disk  is  mounted  as  a  foreign 
device 

•  Verifies  that  both  the  primary  and  secondary  disks  are 
identical  disk  types 

•  Sets  up  the  Shadow  Recording  data  structure  (UMB) ,  which 
starts  the  Shadow  Recording  task  within  the  Executive 

•  Starts  the  copying  of  the  primary  disk  to  the  secondary  disk 
( catchup) 

Format 

START  ddnns  TO  ddxxs 
Parameters 
ddnn : 

The  primary  Files-11  device  that  is  to  be  shadowed  on  the 
secondary  Files-11  device. 

ddxx : 

The  secondary  device  that  is  to  be  the  shadowed  copy  of  the 
primary  device. 

The  START  command  copies  the  primary  disk  onto  any  secondary  disk  of 
the  same  device  type.  After  you  make  the  bad  block  information 
identical  and  then  use  the  START  command,  the  secondary  disk  becomes  a 
logical  duplicate  of  the  primary  disk.  This  means  that  all  copied 
data  blocks,  bad  blocks,  headers,  directories,  and  so  forth  occupy  the 
same  logical  locations  on  the  secondary  disk  as  they  do  on  the  primary 
disk. 

Both  disks  have  equivalent  logical  block  numbers  and,  in  the  case  of 
system  disks,  both  disks  are  bootable.  In  addition,  after  the  START 
command  is  issued,  the  secondary  disk  becomes  a  Files-11  format  disk 
because  the  START  command  makes  an  exact  copy  of  the  primary  disk  on 
the  secondary  disk. 

If  new  data  is  written  to  the  primary  disk  after  Shadow  Recording  is 
initiated  with  the  START  command.  Shadow  Recording  also  writes  the  new 
data  to  the  secondary  disk.  That  is,  when  a  write  occurs  on  the 
primary  disk,  it  also  occurs  on  the  secondary  disk.  However,  the 
secondary  disk  can  only  be  read  from  the  last  portion  that  has  been 
copied.  The  information  about  the  last  block  copied  is  in  the  UMB 
control  block.  A  fully  redundant  secondary  disk  does  not  exist  until 
catchup  has  completed.  Further  action  on  your  part  is  unnecessary 
unless  you  want  to  stop  Shadow  Recording. 
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STOP 


18.2.2  STOP  Command 
The  STOP  commands 

•  Verifies  that  the  primary  device  is  part  of  a  shadowed  pair 

•  Unlinks  the  UMB  data  structure,  if  no  outstanding  I/O  exists, 
thereby  stopping  the  Executive  from  Shadow  Recording 

•  Marks  the  data  structure  for  deletion  if  outstanding  I/O  does 
exist 

Format 

STOP  ddnn: 

Parameters 
ddnn : 


The  device  unit  of  the  primary  device. 

The  STOP  command  prevents  Shadow  Recording  from  continuing.  However, 
during  catchup,  the  STOP  command  cannot  stop  Shadow  Recording.  In 
fact,  if  you  issue  the  STOP  command  during  catchup,  you  receive  an 
error  message.  To  stop  Shadow  Recording  during  catchup,  use  the  ABORT 
command  (see  Section  18.2.3). 

The  absence  of  outstanding  I/O  does  not  necessarily  mean  that  all  file 
activity  has  stopped.  You  must  make  certain  that  all  tasks  that  write 
records  to  the  shadowed  pair  have  stopped  to  ensure  the  integrity  of 
the  secondary  data  before  you  issue  STOP  or  ABORT. 
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ABORT 

18.2.3  ABORT  Command 
The  ABORT  command: 

•  Verifies  that  the  primary  disk  is  part  of  a  shadowed  pair 

•  Aborts  catchup  if  it  is  in  progress  and  then  executes  a  STOP 
command 

•  Stops  Shadow  Recording  even  if  catchup  is  in  progress 
Format 

ABORT  ddnn : 

Parameters 
ddnn : 

The  device  unit  of  the  primary  device. 
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CONTINUE 

18.2.4  CONTINUE  Command 
The  CONTINUE  command: 

•  Assumes  that  the  primary  and  secondary  disks  are  identical 

•  Verifies  that  the  primary  disk  is  in  Files-11  format  and 
mounted  properly 

•  Verifies  that  the  secondary  disk  is  mounted  foreign 

•  Verifies  that  both  disks  are  identical  device  types 

•  Sets  up  the  Shadow  Recording  data  structure,  which  starts 
Shadow  Recording  within  the  Executive 

Format 

CONTINUE  ddnn :  TO  ddxx: 

Parameters 
ddnn : 

The  device  unit  of  the  primary  device. 


ddxx: 


The  device  unit  of  the  secondary  device. 

The  CONTINUE  command  allows  you  to  restart  Shadow  Recording  on  the 
same  two  disks  that  you  were  using  when  the  STOP  command  was  issued. 
The  CONTINUE  command  assumes  that  the  two  disks  are  physically  alike, 
and  it  does  not  check  the  disks  for  equality.  You  must  be  sure  that 
no  writing  occurred  on  the  primary  or  secondary  disks  after  you  issued 
the  STOP  command. 
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DISPLAY 


18.2.5  DISPLAY  Command 

The  DISPLAY  command  shows  all  shadowed  pairs • 

Format 

DISPLAY 

The  shadowed  device  pairs  are  displayed  in  the  following  format: 

UMB  PRIMARY  SECONDARY 

Parameters 

xxxxxx  ddnn:  ddxx: 

xxxxxx 

The  address  of  the  UMB  control  block  for  Shadow  Recording.  This 
control  block  is  in  the  system  Executive  pool  space. 

ddnn: 

The  device  unit  of  the  primary  device. 

ddxx: 

The  device  unit  of  the  secondary  device. 
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18.3  BAD  BLOCK  HANDLING 

Except  for  the  START  command,  which  copies  the  primary  disk  to  the 
secondary  disk,  the  Executive  writes  the  data  from  a buffer 
the  primary  disk  and  then  writes  it  from  the  task  buffer  to  t 
secondary  Ydisk.  If  write  errors  occur  on  one  of  the  disks,  you  may 
not  know  it  until  the  Executive  attempts  to  read  the  block  in  error. 

To  be  notified  of  write  errors  as  they  occur,  you  can  run  Shadow 
Recording  with  write  check  for  both  disks  of  the  shadowed  pair.  The 
MCR  command: 

>SET  /WCHK=ddnn : 

enables  write  check  on  the  device  that  you  specify  in  ddnn:.  However, 
be  aware  that  a  write  check  of  every  write  operation  takes  more  time 

to  execute  than  a  write  only. 

When  write  check  is  enabled,  the  Shadow  Recording  program  prints  the 
error  messages  on  the  console  terminal.  These  error  messages  consist 
of  device  and  logical  block  numbers  when  available. 

In  the  case  of  a  read,  the  Executive  reads  from  the  primary  disk 
first.  If  it  encounters  an  error  on  the  primary  disk,  it  reads  the 
same  record  from  the  secondary  disk.  It  is  unlikely  that  both  dis  s 
would  develop  an  error  in  exactly  the  same  place.  However,  if  y 
do,  a  notification  of  read  errors  on  the  secondary  disk  means  that  the 
primary  disk  is  also  bad  in  the  same  location. 

If  read  errors  occur,  several  procedures  can  be  followed,  as  discussed 
in  the  following  subsections. 


18.3.1  Errors  on  the  Primary  Disk 


If  errors  occur  when  the  Executive  pries  to  read  from  the  primary 
disk  the  Executive  tries  to  read  the  same  record  from  the  secondary 
disk.  You  are  notified  of  the  errors  by  a  message  on  the  console  and, 
at  this  point,  you  may  decide  to  let  your  task  continue.  If  you  do 
decide  to  let  your  task  continue,  be  aware  that  the  shadowed  pair  are 
no  longer  alike. 


If  you  decide  not  to  let  your  task  continue,  stop  the  processing  task 
(or  tasks)  and  use  the  STOP  command  to  stop  Shadow  Recording.  The 
secondary  disk  contains  all  the  data  that  was  on  the  primary 
including  the  bad  block  record.  Use  the  secondary  disk  as  the  new 
primary  disk.  Designate  a  new  device  of  the  same  type  for  the  ne 
secondary  disk.  Mount  the  new  secondary  disk  on  the  secondary  device 

as  foreign. 


After  mounting  the  old  secondary  disk  on  the  primary  device  as  the  new 
primary  disk,  issue  the  START  command.  The  START . command  causes  the 
copying  of  the  primary  disk  to  the  secondary  disk,  including  the  bad 
block  record. 


18.3.2  Errors  on  the  Secondary  Disk 

If  errors  occur  on  the  secondary  disk,  the  shadow  of  the  primary  data 
is  no  longer  valid.  Shadow  Recording  should  be  stopped,  a  new 
secondary  disk  should  be  mounted,  and  Shadow  Recording  restarted.  The 
catchup  task  will  then  copy  the  primary  disk  to  the  new  secondary 
disk . 
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18.3.3  Errors  on  the  Primary  and  Secondary  Disk 

The  simultaneous  occurrence  of  bad  data  in  the  same  blocks  of  two 
disks  is  unlikely,  and  this  kind  of  error  is  not 
recoverable.  However,  whether  or  not  an  error  occurs  at  the  same  or 
different  places  on  both  disks,  the  only  recourse  is  to  stop  Shadow 
Recording  and  your  tasks.  Then,  select  a  new  primary  disk  and  new 
secondary  disk,  mark  the  bad  block  information  on  the  new  primary  disk 
as  before,  and  copy  the  old  primary  disk  to  the  new  primary  disk. 

If  the  error  occurred  on  different  blocks  on  both  disks,  the 
previously  processed  information  can  be  salvaged  by  using  the  old 
primary  and  secondary  as  a  shadowed  pair  input  to  the  Backup  and 
Restore  Utility  (BRU) •  BRU  copies  all  the  data  that  is  on  the  input 
disk  and  writes  it  to  the  output  disk.  If  you  use  a  shadowed  pair  as 
input  to  BRU,  only  the  good  data  is  written  to  the  output  disk  because 
of  the  alternative  read  that  the  Executive  does  on  the  secondary  disk 
if  primary  disk  errors  occur. 

Using  BRU  will  not  give  you  a  new  primary  disk.  You  must  create  a  new 
primary  disk  from  the  output  of  BRU  as  discussed  in  Section  18.1. 

Information  about  how  to  use  BRU  is  in  the  RSX-1 1M/M-PLUS  Utilities 
Manual . 


18.4  SHADOW  RECORDING  MESSAGES 

hh:mm:ss  --  Handler  Error  code-nn.  on  ddnn: 
Shadow  Pair:  ddnn:  ddxx: 

Task :  xxxxxx 

Logical  Block:  nnn . 

Bytes  in  xfer:  nnn. 

File  ID:  n,n 
File  Name:  xxxxxx 

nn.  errors  lost  due  to.  saturation. 


Explanation: 
hh :mm: ss 

The  time  in  hours,  minutes,  and  seconds  of  the  error, 
code-nn . 

The  I/O  error  code  (decimal)  for  the  error. 

I/O  error  codes  are  summarized  in  the  RSX-11M-PLUS 
Mini-Reference . 


File  ID 
File  Name 

The  file  ID  and  file  name  are  printed  only  when  they  can  be 
determined  at  the  time  of  the  error. 

nn.  errors  lost 

When  an  error  occurs  on  a  shadowed  disk,  the  Executive 
notifies  the  shadow  error  reporting  task  that  prints  the 
above  message  on  the  console  terminal.  The  Executive  stores 
the  information  about  the  error  in  pool  for  the  error 
reporting  task  to  pick  up  and  print. 
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If  more  than  fifteen  errors  occur  rapidly,  pool  can  fill  up 
with  error  information  before  the  error  reporting  task  can 
process  it.  This  may  cause  a  shortage  of  pool,  so  that 
there  may  be  no  pool  left  to  run  the  system.  To  prevent 
this  from  occurring,  the  Executive  allows  only  as  many 
errors  as  it  can  process  to  be  queued  in  pool  at  one  time. 
If  fifteen  errors  have  already  taken  place,  and  still  more 
errors  occur,  the  Executive  keeps  track  of  the  errors 
without  processing  them.  The  message  "nn.  errors  lost 
tells  the  user  how  many  errors  were  ignored.  The  term 
"saturation"  refers  to  pool  being  saturated  with  as  many 
error  messages  as  the  Executive  limit  allows • 

This  message  is  only  printed  when  errors  have  not  been 
processed . 

User  Actions  Se^  Section  18.3,  Bad  Block  Handling. 


SHA  —  Abort  error 

Explanations  This  message  occurs  if  the  Shadow  Recording  ABORT 
command  cannot  abort  Shadow  Recording  during  catchup. 

User  Actions  Wait  until  catchup  terminates  and  then  issue  the 
STOP  command. 


SHA  —  Bad  indirect  file  specification 

Explanations  The  indirect  command  file  name  is  incorrect. 

User  Actions  Reissue  the  indirect  command  file  specification. 


SHA  —  Bad  volume  type 

Explanations  The  disk  is  not  in  Files-11  format  or  the  primary 
and  secondary  devices  are  different  device  types. 

User  Actions  Check  the  command  line  or  devices  that  you  are 
trying  to  use. 


SHA  —  Catch-up  completed 

Explanations  This  is  an  informational  message.  The  primary  disk 
has  been  copied  completely  to  the  secondary  disk. 

User  Actions  None. 


SHA  —  Catch-up  in  progress 

Explanations  You  tried  to  issue  a  STOP  command  during  the 
catchup  process . 

User  Actions  Issue  an  ABORT  command  if  catchup  is  still  in 
progress . 
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SHA  —  I/O  error  on  logical  block  nnn. 

Explanation:  An  I/O  error  occurred  during  catchup. 

User  Action:  None,  unless  the  I/O  errors  are  frequent.  If  the 
I/O  errors  are  frequent,  enter  the  ABORT  command,  change  disks, 
and  restart  Shadow  Recording. 


SHA  —  Illegal  command 

Explanations  The  command  that  you  entered 
command . 

User  Actions  Reenter  the  command. 


is  not  a  legal 


SHA  —  Input  error  on  input  command  file 
FILE= 

Explanations  An  error  occurred  while  the  indirect  command  file 
was  being  read. 

User  Actions  Take  appropriate  action;  for  example,  use  a 
different  indirect  command  file,  or  use  a  copy  of  the  specified 
command  file. 


SHA  —  Illegal  parse  data  (internal  error) 

Explanations  This  is  an  internal  system  error.  The  command  was 
correctly  entered. 

User  Actions  Reenter  the  command. 

SHA  —  Invalid  device 

Explanations  The  device  is  not  a  disk  device. 

User  Actions  Check  the  device  specification  and  the  device. 


SHA  —  Maximum  indirect  command  file  depth  exceeded 

Explanations  The  indirect  command  file  was  nested  to  too  many 
levels.  Only  three  levels  are  allowed. 

User  Actions  Check  the  indirect  command  file. 


SHA  —  No  room  available  for  UMB 

Explanations  Not  enough  pool  space  exists  to  allocate  space  for 
the  UMB  control  block  for  Shadow  Recording. 

User  Actions  Check  your  system.  The  system  may  be  on  the  verge 
of  running  out  of  pool  space. 
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SHA  —  Not  a  shadowed  pair 

Explanations  When  STOP  or  ABORT  was  issued,  the  wrong  device  was 
specified . 

User  Actions  Reissue  the  command  with  the  correct  device  unit. 

SHA  —  Open  error  on  input  command  file 
FILE= 

Explanations  The  input  command  file  could  not  he  found. 

User  Actions  Check  the  command  file  and  its  location. 

SHA  —  Privileged  command 

Explanations  You  are  not  using  a  privileged  account  or  terminal. 
User  Actions  Log  in  on  a  privileged  account  or  terminal. 

SHA  —  Send/Receive  error 

Explanations  A  Receive  Executive  directive  error  occurred  in 
Shadow  Recording  during  catchup. 

User  Actions  None.  This  is  a  system  error. 

SHA  —  Shadow  Recording  not  in  system 

Explanations  Shadow  Recording  is  not  part  of  your  system. 

User  Actions  Shadow  Recording  must  be  specified  at  system 
generation . 

SHA  —  Start-up  error 

Explanations  Shadow  Recording  cannot  spawn  the  catchup  task,  so 
Shadow  Recording  exits . 

User  Actions  Restart  Shadow  Recording. 

SHA  —  Syntax  error 

Explanations  The  entered  command  has  incorrect  syntax. 

User  Actions  Reenter  the  command. 

SHA  —  System  error 

Explanations  A  system  error  occurred. 

User  Actions  Determine  the  effects  of  the  error  if  possible. 
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SHA  —  Unknown  command  error 

Explanations  Shadow  Recording  received  a  command  line  that  it 
could  not  recognize. 

User  Action:  Check  the  command  that  you  entered  or  the  indirect 
command  file. 


SHA  —  Volume  currently  part  of  shadowed  pair 

Explanation:  The  specified  device  is  already  being  shadow 

recorded . 

User  Action:  Check  the  devices  being  shadowed  with  the  DISPLAY 
command . 


SHA  —  Volume  not  mounted  properly 

Explanation:  The  primary  device  is  not  mounted  Files-11,  or  the 

secondary  device  is  not  mounted  foreign. 

User  Action:  Check  the  devices  and  mount  them  properly. 


_ 


CHAPTER  19 


DISK  DATA  CACHING  ON  RSX-11M-PLUS  AND  MICRO/RSX  SYSTEMS 


Disk  data  caching  is  a  feature  on  RSX-11M-PLUS  and  Micro/RSX  systems 
that  enhances  I/O  operations  by  reducing  the  number  of  physical  I/O 
requests  directed  to  a  disk. 

The  Data  Cache  Manager  (DCM) ,  also  referred  to  as  the  "cacher" ,  acts 
as  an  intelligent  preprocessor  to  any  disk  driver.  In  addition  to 
monitoring  all  I/O  operations  performed  on  disk  devices,  the  DCM 
decreases  the  number  of  physical  i/o  operations  taking  place  on 
"cached"  disk  drives  by  using  a  cache  region  in  memory.  Copies  of 
disk  data  are  placed  in  the  cache  region,  making  the  data  available 
for  memory-to-memory  transfers  instead  of  disk-to-memory  transfers 
during  an  I/O  request. 

The  DCM  option  is  enabled  by  default  on  Micro/RSX  systems  and  on 
pregenerated  RSX-11M-PLUS  systems.  The  DCM  can  be  chosen  as  a  system 
generation  option  for  RSX-11M-PLUS  systems;  it  is  included  as  part  of 
the  Full-functionality  Executive. 

Disk  data  caching  must  be  activated  explicitly  for  a  disk.  You  can 
activate,  disable,  override,  monitor,  or  modify  disk  data  caching 
using  r,the  commands  in  Sections  19.4  and  19.5. 


19.1  DATA  CACHE  FEATURES 

Disk  data  caching  is  available  for  various  types  of  I/O  operations. 
Caching  is  most  effective  when  blocks  of  data  are  read  repeatedly  or 
accessed  sequentially  in  small  increments.  The  following  list 
describes  types  of  I/O  operations  that  can  be  enabled  or  disabled  for 
data  caching . 

•  Directory  I/O 

Enabled  by  default,  this  operation  can  be  disabled.  All  I/O 
operations  which  are  issued  by  an  ACP  task  with  context 
switching  enabled  are  treated  as  "directory  I/O"  operations. 
Typically,  this  would  be  for  files  such  as  [0, 0]BITMAP. SYS ? , 
[0,0] INDEXF . SYS ; ,  and  the  [0,0]. DIR  [directory]  files. 

•  Overlay  Loads 

Enabled  by  default,  this  operation  -can  be  disabled.  All 
IO.LDO  and  IO.LOV  operations  are  cached  depending  on  their 
size.  If  the  load  request  is  .considered  to  be  too  large,  then 
the  request  is  not  cached.  This  prevents  overlay  loads  from 
monopolizing  the  cache  buffers . 
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•  Data  I/O 


Enabled  by  default,  this  operation  can  be  disabled.  All 
IO.RVB  and  IO.WVB  operations  are  cached.  Operations  which  are 
issued  by  an  ACP  with  context  switching  disabled  are  also 
considered  data  I/O,  to  differentiate  them  from  directory  I/O. 


User  logical  I/O 

Disabled  by  default,  this  operation  can  be  enabled.  All 
IO.RLB  and  IO.WLB  operations  (not  from  an  ACP)  are  considered 
logical  I/O.  Typically,  tasks  that  use  logical  I/O  are  doing 
so  for  a  special  purpose.  BRU,  for  example,  reads  file 
extents  randomly  throughout  the  disk.  In  this  case,  there  is 
little  to  gain  by  caching  this  class  of  operations. 

Read  ahead  for  virtual  I/O 


Disabled  by  default,  this  operation  can  be  enabled.  When  the 
highest  block  of  a  cache  extent  is  read  using  a  virtual  read, 
then,  if  there  is  sufficient  context,  another  extent  of  the 
file's  data  is  loaded  automatically  by  the  cache,  without 
having  been  requested  by  the  user .  The  maximum  number  of 
blocks  that  can  be  read  is  the  number  of  blocks  in  the  extent 
or  the  number  of  blocks  in  the  maximum  extent  size.  This 
operation  is  beneficial  for  disks  that  contain  numerous 
sequential  files  which  are  frequently  accessed  sequentially. 


Cache  I/O  is  handled  by  the  cache  code.  During  a  read  operation  for  a 
type  of  I/O  that  is  to  be  cached,  the  DCM  intercepts  an  I/O  request 
and  checks  the  request  against  the  data  stored  in  memory.  If  the 
correct  data  is  stored  in  memory,  the  DCM  processes  the  request.  If 
the  cache  does  not  contain  the  requested  data,  the  DCM  forwards  the 
I/O  request  to  the  appropriate  driver  for  processing.  When  the 
physical  I/O  completes,  the  DCM  resumes  processing  by  copying  the 
appropriate  portion  of  the  data  to  the  user  s  buffer • 

During  a  write  operation  for  a  type  of  I/O  that  is  to  be  cached,  the 
appropriate  data  is  copied  from  the  user's  buffer  to  the  corresponding 
cache  buffer.  If  there  is  no  corresponding  cache  buffer,  the  request 
is  forwarded  to  the  disk  driver  for  processing,  and  the  data  is  not 
cached.  When  the  copy  operation  is  finished,  the  DCM  completes  the 
I/O  by  passing  the  user's  packet  to  $IOFIN. 

Special  handling  is  required  to  ensure  that  the  cache  buffers  reflect 
valid  data  for  mounted  disks  only.  For  that  purpose,  the  cache 
handles  the  IO.STC  operation.  Normally,  IO.STC  is  issued  by  the  MOUNT 
command  as  part  of  mount  processing,  and  by  DMOUNT  as  part  of  dismount 
processing  (for  /UNLOAD)  in  order  to  set  hardware  and  software  volume 
valid .  When  the  cache  manager  receives  the  mount  parameters ,  it 
initializes  the  cache  (this  may  include  purging  the  cache  before 
initialization  to  prevent  stale  data  from  a  removed  disk  pack  from 
being  used),  and  duplicates  and  dispatches  the  user's  packet  while 
retaining  the  original  request.  The  status  is  returned  to  the  user 
via  $IOFIN.  If  the  operation  was  successful,  the  related  cache  region 
use  count  is  incremented,  to  prevent  its  deallocation.  When  a 
dismount  packet  is  received,  the  user's  packet  is  stalled  until  all 
outstanding  buffers  (if  any)  are  written  to  the  disk  first.  All 
further  cache  processing  is  disabled  for  that  device.  When  the  cache 
context  for  the  drive  is  clear,  the  stalled  dismount  request  is 
-forwarded  to  the  driver. 
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19.2  DATA  CACHE  MANAGER  (DCM) 

The  Data  Cache  Manager  (DCM)  is  the  code  that  provides  data  cache 
support.  It  resides  in  a  directive  common.  The  DCM  is  responsible 
for  monitoring  disk  data  cache  operations.  It  ensures  that  disk  data 
is  stored  in  memory  and  that  the  data  stored  in  memory  is  available 
for  use  during  I/O  requests. 

The  DCM  executes  within  the  I/O  system  after  all  packet  preprocessing 
and  before  disk  driver  activation.  The  DCM  will  execute  if  the  device 
is  a  mass  storage  device  (DV.MSD)  and  not  a  tape  device  (not  DV.SQD). 
If  the  device  to  which  an  I/O  request  is  directed  is  not  a  disk  (or 
the  cache  support  is  not  within  the  Executive),  the  driver  will  be 
mapped  and  activated  at  the  initiation  entry  point.  The  positioning 
of  the  DCM  at  this  point  in  processing  allows  all  i/o  packets  to  be 
intercepted  when  all  but  the  driver  processing  (including  the 
placement  of  the  request  into  the  device  queue)  has  been  performed  for 
the  packet. 

In  order  for  the  cacher  to  run,  regions  must  be  established  for 
caching,  and  the  devices  which  are  to  use  them  must  be  notified.  This 
requires  that  the  appropriate  commands  be  used  to  define  and  enable 
caching  (see  sections  19.4  and  19.5). 


19.2.1  PERMANENT  DCM  IN  A  SYSTEM  CONFIGURED  USING  VMR 

The  following  VMR  commands  are  provided  in  SYSVMR.CMD  to  permanently 
include  disk  data  caching  as  a  directive  common  in  the  bootstrapped 
system: 


INS  DCMEXP 
FIX  DCMEXP/DIR 


19.3  THE  DATA  CACHE  REGION 

A  data  cache  region  must  be  created  and  formatted  before  caching  is 
activated.  If  you  want  to  use  a  region  other  than  the  default  region 
provided  by  the  system,  you  must  specify  the  region  name  when  you 
create  a  cache  region.  When  the  device(s)  associated  with  a  cache 
region  has  completed  processing,  the  cache  region  is  deactivated  (but 
not  deleted)  by  a  DISMOUNT  or  SET  command.  Section  19.4  describes  the 
DCL  commands  used  to  specify,  create,  and  deactivate  a  cache  region. 
Section  19.5  describes  MCR  commands  to  specify,  create,  and  deactivate 
a  cache  region . 

The  data  cache  region  contains  extents .  Extents  are  ranges  of 
physically  contiguous  memory  blocks  which  are  memory-resident  copies 
of  ranges  of  physically  contiguous  disk  blocks.  These  blocks  are 
tagged  with  their  corresponding  disk  logical  block  numbers  (LBN)  so 
that  they  can  be  found  in  the  cache . 

The  blocks  of  disk  data  are  stored  in  a  cache  region  during  a  request 
for  a  read  operation  or  when  read-ahead  is  enabled.  If  read-ahead  is 
enabled,  blocks  of  data  residing  in  the  same  extent  as  a  read  request 
are  also  placed  in  the  cache  region.  As  blocks  of  data  are  placed  in 
a  cache  region,  they  are  tagged  with  their  LBNs  so  that  the  data  can 
be  found  during  a  subsequent  I/O  request. 
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TO  maintain  a  V"  ^ 

SHOW  command  to  monitor  a  cache  region  ^  *ell  as  f  ^^InSrmatL^on 

DCM.  See  Sections  19.4.2,  auu 

monitoring  a  data  cache  operation. 

Typical  RSX-11M-PI.US 

Sy  ??ss  Zh°y&  sUr  '*—*  ssssTp uSsr.r. 

Partitions  (EXP),  and  task  g  •,■  data  structures  and  dish 

sa-^SrS!  —  *«. «*. 

following  PCB  status  bits: 


P • STAT 

PS.FXD  -  Region  is  fixed  in  memory 
PS.NSF  -  Region  is  not  shuffleable 
PS.COM  -  Region  is  a  common 

P . PRO  —  Protection  word  blocking  all  access  C, , 


P2.R0N  -  Read  only  (external  users) 

P2.APR  -  Depends  on  Executive: 

P2.APR  =  5  for  i/D  systems 
P2.APR  =  6  for  non-l/D  systems 
P2.LMA  -  Do  not  remove  this  region 
P2.CHE  -  Cache  region  (informational  only) 


Cache  reaions  may  be  shared  by  multiple  devices,  or  one  region  may  be 
S5  exc?isive“  by  one  device.  When  caching  is  enabled  for  a  device 
“-I-  default^cache  . eg  ion,  yarned 

formatted8 for^the  cacher  to  be  able  to  use  it.  The  region  may  also  be 
in  use  by  another  device  that  has  caching  enabled. 


19.3.1  CREATION  AND  DELETION 

Data  cache  regions  are  allocated  and  deallocated  by  the  appropriate 

sssn.  saii1:  “iflir*?" 

olf^hf8re^nTith£tSe  ^e„  leg 

deallocation,  the  P.RMCT  field  (resident,  mapped  task  count)  ref 
i-he  number  of  devices  which  currently  have  caching  enabled  for  that 
region  T?e  region  cannot  be  deleted  as  long  as  P.RMCT  ts  non-zero. 
When  there  are  no  devices  with  access  for  that  region,  P2.LMA 
cleared,  allowing  the  region  to  be  removed  from  the  system. 


19.3.2  FORMAT 

The  data  cache  region  has  two  parts.  (See  Figure  19-1.)  The  beginning 
of  the  region  contains  pool  space.  Non-l/D  systems  map  pool  through 
APR  6  and  hive  a  4KW  limitation;  I/D  systems  map  pool  th*°“gh  data 
soace  APR  5  and  APR  6  with  an  8KW  limitation.  The  standard  $AL0CB 
(entry  point  $AL0C1)  and  $DEACB  (entry  point  $DEAC1),  which  are  the 
Ii  y„??oletion  and  deallocation  routines  within  the  Executive,  are 
!£°d  to' allocate  a^deSocate  space  from  this  area.  The  dynamic 
data  structures,  which  are  cache-specific,  are  retained  in  this  ar 

to  minimize  the  load  of  data  caching  on  the  primary .JP0* atl^blocks’ 
The  remainder  of  the  cache  region  is  used  to  buffer  disk  data  bloc  . 
It  is  allocated  on  32-word  boundaries  in  256-word  increments. 
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The  Cache  Extent  Descriptor  (CED)  is  a  data  structure  within  the 
region's  pool  that  describes  all  data  buffer  space  in  the  cache 
region,  whether  the  space  is  in  use  or  not.  This  allows  contiguous 
blocks  of  space  to  be  reclaimed  when  needed. 


/  Cache-specific  pool 
^  Dish  data  butter  space 


ZK-41 87-85 

Figure  19-1:  Format  of  Data  Cache  Region 


The  pool  area  of  the  cache  region  contains  a  header  which  is  used  to 
control  various  region-specific  structures.  (See  Figure  19-2.) 

+00 


+02 


+  10 


+  14 


+20 


+24 
+26 
ZK-4188-85 


H.CSTS 

H.IIOC 

— 

H.PAVL 

— 

— 

H.PKTQ 

— 

— 

H.CMDH 

— 

— 

H.CEDH 

— 

H. TEMPI 

H.TEMP2 

Figure  19-2:  Format  of  Pool  Header  Area 


H.CSTS  Region  code  status.  The  following  bits  are 
defined  in  this  byte: 


CS.REQ  =  1 
CS.RIN  =  2 
CS.DNF  =  4 
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H • I IOC 

H . PAVL 


H.PKTQ 


H.CMDH 

H.CEDH 


Region  internal  I/O  count.  This  is  not 
used  by  the  data  cache. 

Pool  available  list.  This  is  a  standard 
3-word  pool  list  head r  which  contains  the 
alignment  word  followed  by  the  list  head, 
which  is  a  pointer  to  the  next  available 
block  and  the  size  of  the  block. 

Pending  packet  queue  (in  descending 
priority  order) •  These  packets  are 
waiting  for  data  cache  completion 
processing.  They  either  have  I/O  in 
progress,  are  waiting  for  data  movement  to 
begin,  or  are  waiting  to  be  dispatched  to 
either  the  user  [$IOFIN]  or  the  driver. 

List  head  for  region  buffer  space 
allocation . 

List  head  for  CEDs  ordered  by  age  (the 
oldest  are  at  the  head  of  the  queue) . 


H. TEMPI  Pointer  used  in  allocating  new  extents 


H.TEMP2  Pointer  used  in  allocating  new  extents 


The  region  is  formatted  before  caching  is  enabled  on  any  dependent 
disk  devices. 


19.4  DCL  COMMANDS  USED  WITH  DISK  DATA  CACHING 

This  section  describes  the  DCL  commands  and  qualifiers  you  use  to  do 
the  following: 

•  Associate  caching  with  a  device 

•  Specify  the  type  of  caching  you  want  enabled 

•  Monitor  data  cache  operations 

•  Modify  data  cache  operations 

19.4.1  MOUNT  Command 

The  MOUNT  command  makes  a  disk  volume  available  for  processing.  To 
associate  caching  with  a  selected  disk,  use  the  /CACHE  qualifier  wit 
the  MOUNT  command . 

Format 

MOUNT  ddnn : volumelabel  /[NOJCACHE [:  (opt ion  , opt ion , . . .) ] 

Parameters 

ddnn: 


Specifies  the  device  on  which  the  volume  is  to  be  mounted, 
volumelabel 

Specifies  the  name  that  is  associated  with  that  volume. 
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Qualifiers 

/CACHE 

Lets  you  associate  caching  with  the  specified  disk,  and  allows 
you  to  override  the  disk  data  caching  defaults  and  set  one  or 
more  of  the  options . 

The  following  options  are  available  with  disk  data  caching: 

CREATE[ : [ region] [ : [main_partition] [ : [ cache_size] ] ] ] 

REGION: name 

[ NO ]DI RECTORY [  :  extent__size] 

[NO]LOGICAL[ :extent_size] 

[NO]OVERLAY[ : extent_size] 

[NO]READ_AHEAD[ :extent_size] 

[NO]VIRTUAL[ :extent_size] 

The  extent_size  argument  specifies  the  maximum  size  of  an  I/O 
request  that  will  be  considered  for  caching.  The  extent  size 
radix  is  decimal.  The  minimum  value  for  an  extent  size  is  1;  the 
maximum  is  15.  Extent  sizes  can  be  modified  for  cached  devices 
using  the  SET  command. 

/NOCACHE 

Specifies  that  caching  is  not  associated  with  the  device  being 
mounted . 

Options 

CREATE[ : [ region] [ : [main_partition] [ : [size] ] ] ] 

Creates  a  cache  region  and  associates  caching  with  the  specified 
device  in  that  region. 

The  default  name  for  the  region  is  CACHE;  the  default  name  for 
the  main  partition  is  GEN.  The  default  size  is  100 (decimal)  disk 
blocks . 

REGION :name 

Associates  caching  for  the  specified  device  with  an  already 
existing  cache  region. 

You  can  specify  a  region  to  be  used  in  place  of  the  system 
default.  The  default  region  is  CACHE. 

[NO]DIRECTORY[ :extent_size] 

DIRECTORY  enables  caching  of  directory  I/O.  This  is  the  system 
default  and  need  not  be  specified. 

NODIRECTORY  disables  caching  directory  I/O.  You  must  specify 
this  option  if  you  want  to  disable  caching  of  directory  I/O. 

The  default  extent  size  for  DIRECTORY  is  1. 

[NO]LOGICAL[  :extent__size] 

LOGICAL  enables  caching  of  logical  I/O.  You  must  specify  this 
option  if  you  want  to  enable  caching  of  logical  I/O. 

NOLOGICAL  disables  caching  of  logical  I/O.  This  is  the  default. 

The  default  extent  size  for  LOGICAL  is  1. 
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[NO]OVERLAY[ :extent_size] 

OVERLAY  enables  caching  of  overlay  I/O.  This  is  the  system 
default . 

NOOVERLAY  disables  caching  of  overlay  I/O.  You  must  specify  this 
option  if  you  want  to  disable  caching  of  overlay  I/O. 

The  default  extent  size  for  OVERLAY  is  4. 

[NO]READ_AHEAD[ :extent_size] 

READ  AHEAD  enables  reading  of  data  (for  virtual  I/O)  before 
explicitly  requested.  You  must  specify  this  option  if  you  want 
to  enable  reading  of  data  before  explicitly  requested. 

NOREAD_AHEAD  disables  reading  of  data  before  it  is  explicitly 
requested.  This  is  the  default. 

The  default  extent  size  for  READAHEAD  is  5. 

[ NO ] VI RTUAL [ :extent_size] 

VIRTUAL  enables  caching  of  virtual  i/O.  This  is  the  system 

default . 

NOVIRTUAL  disables  caching  of  virtual  I/O.  You  must  specify  this 
option  if  you  want  to  disable  caching  of  virtual  I/O. 

The  default  extent  size  for  VIRTUAL  is  5 . 


19.4.2  SHOW  CACHE  Command 

Once  disk  data  caching  is  established  through  the  MOUNT  or  SET 
command,  you  can  monitor  the  performance  of  data  caching  using  the  DCL 
command  SHOW  CACHE.  This  command  allows  you  to  display  system 
information  on  data  caching.  To  display  data  cache  information  on  a 
specific  device,  you  must  supply  the  device  name  on  the  command  line. 

Format 

SHOW  CACHE  [/DEVICE=ddnn:]  [ /REGION=name]  [/RATE:n] 

Qualifier 
/ DEVICE=ddnn : 

Specifies  the  device  about  which  you  want  to  display  detailed 
data  cache  information.  Note  that  /DEVICE  and  /REGION  cannot  be 
used  together . 

/REGION=name 

Specifies  the  cache  region  about  which  you  want  to  display 
general  data  cache  information.  Note  that  /DEVICE  and  /REGION 
cannot  be  used  together . 

/RATE :n 

Specifies  in  seconds  the  rate  at  which  the  screen  refreshes.  The 
default  rate  is  1  second. 
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19.4.3  SHOW  DEVICE  Command 

Once  disk  data  caching  is  established  through  the  MOUNT  or  SET 
command,  you  can  list  cached  devices  using  the  DCL  command  SHOW 
DEVICE.  This  command  displays  information  about  devices  recognized  by 
the  system.  To  display  information  about  a  particular  device,  you 
must  specify  the  device  name  on  the  command  line. 

Format 

SHOW  DEVICE  [ddnn : ]  /[NO]CACHE 
Parameter 
ddnn : 


Specifies  the  device  for  which  you  are  displaying  information. 
Qualifier 
/CACHE 

Lists  all  devices  known  to  the  system  that  are  cached  (if  no 
device  is  specified) . 

/NOCACHE 

Lists  devices  that  are  not  cached,  but  could  be  cached. 


19.4.4  SET  DEVICE  Command 

To  modify  data  caching  on  your  system,  or  to  associate  caching  with  a 
device,  use  the  DCL  command  SET  DEVICE.  This  command  allows  you  to 
modify  various  system  values  and  behavior.  To  modify  the  behavior  or 
the  value  of  specific  devices,  you  must  supply  the  device  name.  Note 
that  a  region  associated  with  a  specific  device  cannot  be  modified 
while  caching  is  enabled  for  that  device. 

Format 

SET  DEVICE  ddn :  /[NO ]CACHE[ :( option , option ,...) ] 

Parameter 
ddnn : 


Specifies  the  device  you  are  modifying. 
Qualifiers 
/CACHE 


Modifies  the  data  caching  behavior  for  the  specified  device.  You 
may  modify  the  following  options: 

CREATEt : region] [ : [main_partition] [ : [ cachesize] ] ] ] 

REGION: name 

[NO] DIRECTORY[ : extent_size] 

[NO] LOGICALC : extent_size] 

:NO]OVERLAY: : extent_size] 

:NO]READ_AHEAD: : extent_size] 

:N0 ] VIRTUAL: : extent  size] 


19-9 


DISK  DATA  CACHING  ON  RSX-11M-PLDS  AND  MICRO/RSX  SYSTEMS 


The  extent  size  argument  specifies  the  maximum  size  of  an  I/O 
request  that  will  be  considered  for  caching.  The  extent  size 
radix  is  decimal.  The  minimum  value  for  an  extent  size  is  1;  the 
maximum  is  15.  Extent  sizes  can  be  modified  for  cached  devices 
using  the  SET  command • 

These  options  are  described  in  Section  19.4.1. 

/NOCACHE 

Deactivates  caching  for  the  specified  device. 


19.5  MCR  COMMANDS  USED  WITH  DISK  DATA  CACHING 

This  section  describes  the  MCR  commands  and  qualifiers  you  use  to  do 
the  following: 

•  Associate  caching  with  a  device 

•  Specify  the  type  of  caching  you  want  enabled 

•  Monitor  data  cache  operations 

•  Modify  data  cache  operations 


19.5.1  MOUNT  Command 

The  MOUNT  command  makes  a  disk  volume  available  for  processing.  To 
associate  caching  with  a  selected  disk,  use  the  /CACHE  qualifier  with 
the  MOUNT  command . 

Format 

MOUNT  ddnn : volumelabel  / [NO]CACHE [: (opt ion , option ,...) ] 

Parameters 
ddnn : 

Specifies  the  device  on  which  the  volume  is  to  be  mounted, 
volumelabel 

Specifies  the  name  that  is  associated  with  that  volume. 

Qualifiers 

/CACHE 

Lets  you  associate  caching  with  the  specified  disk,  and  allows 
you  to  override  the  disk  data  caching  defaults  and  set  one  or 
more  of  the  options. 

The  following  options  are  available  with  disk  data  caching: 

CREATE  [:  [region]  [:  [main_parti t ion]  [:  [cache_size] ] ] ] 

REGION: name 

[NO] DIRECTORY [ : extent  size] 

[NO] LOGICAL [ :extent_s7ze] 

[NO] OVERLAY [ : ex tent_si ze] 

[NO] READ_AHEAD [ : ex ten t_s i ze] 

[NO] VIRTUAL [: ex tent_size] 
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The  extent__size  argument  specifies  the  maximum  size  of  an  I/O 
request  that  will  be  considered  for  caching.  The  extent  size 
radix  is  decimal.  The  minimum  value  for  an  extent  size  is  1;  the 
maximum  is  15.  Extent  sizes  can  be  modified  for  cached  devices 
using  the  SET  command. 

/NOCACHE 

Specifies  that  caching  is  not  associated  with  the  device  being 
mounted . 

Options 

CREATE [  :  [ region]  [  :  [main_partition]  [  s  [  size]  ]  ]  ] 

Creates  a  cache  region  and  associates  caching  with  the  specified 
device  in  that  region. 

The  default  name  for  the  region  is  CACHE;  the  default  name  for 
the  main  partition  is  GEN.  The  default  size  is  lOO(decimal)  disk 
blocks . 


REGION : name 

Associates  caching  for  the  specified 
existing  cache  region. 

device  with 

an 

already 

You  can  specify  a  region  to  be  used 
default.  The  default  region  is  CACHE. 

in  place  of 

the 

system 

[ NO ]DI RECTORY [ : extent  size] 

DIRECTORY  enables  caching  of  directory 
default  and  need  not  be  specified. 

I/O .  This  is 

the 

system 

NODIRECTORY  disables  caching  directory 

I/O.  You  must 

specify 

this  option  if  you  want  to  disable  caching  of  directory  I/O. 

The  default  extent  size  for  DIRECTORY  is  1. 

[ NO ] LOG I CAL [ :extent_size] 

LOGICAL  enables  caching  of  logical  I/O.  You  must  specify  this 
option  if  you  want  to  enable  caching  of  logical  I/O. 

NOLOGICAL  disables  caching  of  logical  I/O.  This  is  the  default. 

The  default  extent  size  for  LOGICAL  is  1. 

[NO]OVERLAY[  :  extent__size] 

OVERLAY  enables  caching  of  overlay  I/O.  This  is  the  system 

default. 

NOOVERLAY  disables  caching  of  overlay  I/O.  You  must  specify  this 
option  if  you  want  to  disable  caching  of  overlay  I/O. 

The  default  extent  size  for  OVERLAY  is  4. 

[ NO ] READ_AHEAD [ : extent_size] 

RE AD_AH EAD  enables  reading  of  data  (for  virtual  I/O)  before 
explicitly  requested.  You  must  specify  this  option  if  you  want 
to  enable  reading  of  data  before  explicitly  requested. 
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NOREAD  AHEAD  disables  reading  of  data  before  it  is  explicitly 
requested .  This  is  the  default . 

The  default  extent  size  for  READAHEAD  is  5. 

[NO ]VIRTUAL[ :extent_size] 

VIRTUAL  enables  caching  of  virtual  I/O.  This  is  the  system 
default . 

NOVIRTUAL  disables  caching  of  virtual  I/O.  You  must  specify  this 
option  if  you  want  to  disable  caching  of  virtual  I/O. 

The  default  extent  size  for  VIRTUAL  is  5, 


19.5-2  RMD  C  Command 

Once  disk  data  caching  is  established  through  the  MOUNT  or  SET 
command ,  you  can  use  the  RMD  command  to  monitor  performance. 

The  RMD  command  allows  you  to  display  various  pages  of  system 
information.  The  RMD  C  command  allows  you  to  display  the  C  page, 
which  shows  general  statistics  about  a  particular  cache  region.  After 
you  analyze  this  information,  you  can  use  the  SET  command  to  modify 
system  values  and  behaviors  to  possibly  enhance  performance. 

Format 

RMD  C  [ ,REGION=region][ ,RATE=nn] 

Setup  Commands 
REGION 

Selects  the  cache  region  to  be  displayed.  The  default  region  is 
CACHE . 

RATE 

Specifies  the  number  of  seconds  between  screen  refreshes.  The 
default  is  1  second. 

Example 

Figure  19-3  is  a  sample  RMD  C  page  display;  it  is  followed  by  an 
explanation . 
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Figure 

19-3: 

RMD  C  Page  Display 
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Cache  Region  Name  indicates  the  name  of  the  cache. 

Region  Size  shows  the  actual  memory  size  in  octal  of  the 
cache  region  in  32-word  memory  blocks.  This  size  includes 
the  private  cache  pool  area  as  well  as  the  extent  storage 
area.  The  second  part  of  the  size  field  displays  the  size  of 
the  extent  storage  area  in  disk  blocks. 

The  Total  Reads  field  displays  the  count  of  all  read  requests 
issued  to  that  device.  These  include  VIRTUAL,  READAHEAD, 
DIRECTORY,  LOGICAL,  and  OVERLAY  read  requests. 

The  Hit  Rate  is  the  percentage  of  all  read  requests  that  were 
satisfied  by  the  cache. 

The  Fail  Rate  is  the  percentage  of  all  read  requests  that 
could  not  be  satisfied  by  the  cache  because  of  an  extent 
overlap  or  a  cache  pool  allocation  failure,  or  because  the 
request  size  exceeded  the  specified  extent  size  limit. 


Actual  errors  in 
counted  in  this 

loading  the  cache 
rate . 

from 

the 

disk  are 

not 

The  Load  Rate  is 

the  percentage  of 

all 

read 

requests 

that 

resulted  in  data  being  loaded  into  the  cache.  The  total  of 
the  Hit,  Fail,  and  Load  rates  should  be  close  to  100%.  The 
total  may  not  always  equal  100%,  because  read  requests  can 
fail  because  of  a  primary  pool  allocation  failure,  which  is 
not  associated  directly  with  read  or  write  requests.  The 
failure  rate  of  primary  pool  allocation  is  shown  on  the  RMD  D 
page;  it  should  be  small. 

The  Total  Writes  field  displays  the  count  of  all  write 
requests  issued  to  that  device.  These  include  VIRTUAL, 
DIRECTORY,  and  LOGICAL  write  requests. 

The  Hit  Rate  is  the  percentage  of  all  write  requests  that 
caused  updating  of  blocks  already  loaded  in  the  cache. 

The  Fail  Rate  is  the  percentage  of  all  write  requests  that 
could  not  be  directed  to  the  cache  because  of  an  extent 
overlap.  The  Hit  Rate  and  Fail  Rate  will  not  total  100%, 
because  a  write  miss  is  not  considered  a  write  failure. 
Also,  write  requests  to  a  cache  can  fail  because  of  a  primary 
pool  allocation  failure,  which  is  not  associated  directly 
with  read  or  write  requests.  The  failure  rate  of  primary 
pool  allocation  is  shown  on  the  RMD  D  page?  it  should  be 
small . 

The  Defer  Rate  is  the  percentage  of  all  write  requests  that 
were  deferred;  that  is,  the  actual  write  operation  to  the 
disk  was  done  some  time  after  the  user's  write  request  was 
completed . 

The  Total  I/O  Operations  is  the  total  of  all  read  and  write 
operations  for  that  device. 

The  Cache  Used  field  indicates  the  percentage  of  the  cache 
extent  storage  area  used  by  the  device. 

The  bottom  line  displays  the  grand  totals  for  the  region. 
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19.5.3  RMD  D  Command 

The  RMD  D  command  allows  you  to  display  the  D  page  of  the  RMD  display, 
which  shows  detailed  statistics  about  a  particular  cached  device. 
After  you  analyze  this  information,  you  can  use  the  SET  command  to 
modify  system  values  and  behaviors  to  possibly  enhance  performance. 

Format 

RMD  D[,DEVICEl=ddnn:][,RATE=nn] 

Setup  Commands 
DEVICE1 

Specifies  the  device  to  be  displayed.  The  default  device  is  SY: . 

RATE 

Specifies  the  number  of  seconds  between  screen  refreshes.  The 
default  is  1  second. 


Example 


Figure  19-4  is  sample  RMD  D  page  display?  it  is  followed  by 
explanation. 
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Primary  Pool  Allocation  Failure  Rate  (as  a  %  of  Total  I/Os ) •  0% 
Cache  Pool  Allocation  Failure  Rate  (as  a  %  of  Total  Read  I/Os)*  0% 
Read  Load  Failure  Rate  (as  a  %  of  Cache  Load  I/Os)*  OX 
Deferred  Write  Rate  (as  a  %  of  Total  Write  I/Os)*  0% 


Figure  19-4:  RMD  D  Page  Display 


Q  The  Region  Name  and  Region  Size  fields  are  the  same  as  in  the 
C  page  description,  except  that  the  extent  storage  area  size 
in  disk  blocks  is  not  displayed. 

0  The  Cache  Status  field  shows  whether  the  cache  is  ACTIVE 
and/or  ENABLED.  ACTIVE  means  the  device  is  being  cached 
through  the  region?  ENABLED  means  that  the  device  will 
automatically  be  cached  when  it  is  mounted  (even  if  the  MOUNT 
command  does  not  explicitly  request  that  the  device  be 
cached) . 
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The  Requests  Being  Cached  field  shows  the  types  of  cache  I/O 
operations  enabled  for  the  device.  The  types  can  be  VIRTUAL 
(VIR),  READAHEAD  ( RDH ) ,  DIRECTORY  (DIR),  LOGICAL  (LOG).  and 
OVERLAY  (OVR).  '  '' 


O  The  Reads  section  shows  the  number  of  read  requests  issued 

for  each  of  the  I/O  types  listed  in  the  display,  as  well  as 

the  total  of  all  read  requests. 

©  These  four  lines  show  the  Read  Hit  Rate,  the  Read  Load  Rate, 
the  Read  Overlap  Rate,  and  the  Extent  Too  Big  rate  for  each 
type  of  request.  Each  of  these  rates  is  computed  as  a 
percentage  of  the  total  number  of  read  operations  for  the 
particular  type  of  request. 

©  The  Maximum  Extent  Size  for  each  of  the  I/O  types. 

©  The  Writes  section  shows  the  number  of  write  requests  issued 

for  each  of  the  I/O  types  and  the  total  of  all  write 
requests.  Note  that  READAHEAD  and  OVERLAY  write  requests  do 
not  exist,  so  these  fields  are  blank. 

©  The  Write  Hit  Rate  and  Write  Overlap  Rate  for  each  type  of 
l/o  request.  Each  of  these  rates  is  computed  as  a  percentage 
of  the  total  number  of  write  operations  of  a  particular  type. 

©  The  total  amount  of  each  type  of  I/O,  as  well  as  the  total 
amount  of  all  I/O. 


©  The  last  four  lines  show  rates  that  are  not  accumulated  by 
I/O  type.  All  cache  I/O  requests  require  that  an  I/O  packet 
be  allocated  from  primary  pool. 


The  Primary  Pool  Allocation  Failure  Rate  line  shows  how  often 
the  allocation  cannot  be  done  as  a  percentage  of  the  total 
number  of  I/Os  issued  for  that  device. 

The  Cache  Pool  Allocation  Failure  Rate  is  similar  to  the 
failure  rate  for  primary  pool  allocation,  except  that 
allocation  from  the  cache  pool  is  only  required  on  read 
operations.  The  rate  is  therefore  computed  as  a  percentage 
of  the  total  number  of  read  operations . 

The  Read  Load  Failure  Rate  is  the  percentage  of  all  cache 
load  attempts  that  failed  because  of  an  I/O  error. 

The  Deferred  Write  Rate  is  the  rate  that  write  operations 
were  able  to  be  deferred.  This  is  computed  as  a  percentage 
of  the  total  number  of  write  operations . 


19.5.4  DEV  Command 

The  DEV  command  displays  system  information  about  various  devices.  If 
no  device  is  specified,  then  all  the  devices  known  to  a  system  are 
listed.  If  a  device  but  no  unit  is  specified,  then  all  the  units  of 
that  device  are  listed  with  some  minimum  amount  of  status.  If  both  a 
device  and  unit  are  specified,  then  the  maximum  amount  of  information, 
including  the  current  cache  attributes  for  that  particular  device,  are 
displayed . 

Format 

DEV  [dd[nn]:] 
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Parameters 

dd: 

Specifies  the  devices  about  which  information  will  be  displayed, 
nn 

Specifies  the  unit  of  a  particular  device,  about  which 
information  will  be  displayed. 


19.5.5  SET  Command 

The  MCR  command  SET  allows  you  to  display  and  modify  various  system 
values  and  behaviors;  it  also  allows  you  to  associate  caching  with  a 
device.  If  no  device  is  specified,  then  all  the  devices  with  * 
corresponding  cache  status  are  listed.  If  a  device  is  specified,  then 
the  current  cache  behavior  for  that  device  is  modified  appropriately. 
The  region  size  can  only  be  specified  when  you  create  a  cache  region 
(see  the  CREATE  option).  The  region  name  can  only  be  modified  ^hi  e 
all  types  of  caching  are  disabled  for  that  device  (see  the  REGION 

option) . 


Format 

SET  / [NO] CACHE [ : ddnn : [ ( option , ...)]] 

Qualifiers 

/CACHE 

If  no  device  is  specified,  lists  devices  with  disk  data  caching 
enabled.  If  a  device  is  specified,  enables  caching  or  modifies 
the  caching  behavior . 

/NOCACHE 

Lists  devices  with  disk  data  caching  disabled.  You  can  specify  a 
device  but  no  options  with  the  /NOCACHE  qualifier. 


Argument 

ddnn: 


Specifies  the  device  to  be  modified. 

Options 

The  following  options  are  available  with  disk  data  caching: 

CREATE[  :  [region]  [  :  [main__partition]  [  :  [size]  ]  ]  ] 

REGION : name 

[NO ]DI RECTORY [ : extent_size] 

[NO]LOGICAL[ :extent_size] 

[NO]OVERLAY[ :extent_size] 

[ NO ] READ_AHEAD [ : extent_size] 

[NO]VIRTUAL[  :extent__size] 

These  options  are  described  in  section  19.5.1. 
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SERIAL  DESPOOLER  TASK 


The  Serial  Despooler  Task  ( PRT . . . )  provides  a  means  of  eliminating 
contention  for  the  system  line  printer.  Rather  than  waiting  for  the 
line  printer  to  become  available,  a  task  directs  the  output  intended 
for  the  line  printer  to  a  disk  file.  The  task  issues  a  Send  Data 
directive  to  the  serial  despooler,  placing  a  data  block  that 
identifies  the  file  to  be  spooled  in  the  serial  despooler  queue.  A 
Request  directive  is  then  issued  by  the  task  to  activate  the  serial 
despooler,  in  case  it  is  not  already  active.  PRT  handles  FCS-created 
files,  but  RMS  files  can  be  read  only  if  they  are  sequential.  All 
files  identified  in  the  serial  despooler  queue  are  printed  in 
first-in/ first-out  (FIFO)  order. 


You  may  wish  to  compare  the  capability  of  this  task  with  the  RSX-11M 
Queue  Manager  and  its  associated  despooler.  See  Chapter  7  for  more 
information  about  the  Queue  Manager. 


A. 1  RECEIVE  QUEUE  OPERATION 

The  standard  method  of  placing  a  user  file  in  the  serial  despooler 
receive  queue  (and  requesting  its  execution)  is  through  the  PRINT$ 
macro  call,  which  is  described  in  the  RSX-11M/M-PLUS  and  Micro/RSX  i/o 
Operations  Reference  Manual.  Files  are-spooled  in  thli“sime  manner-^ 
the  RSX-11  utilities  that  support  the  spool  (/SP)  option.  Each  entry 
in  the  serial  despooler  receive  queue  consists  of  a  13-word  data  block 
containing  the  file-related  information  illustrated  in  Figure  A-l . 


A. 2  TEXT  REQUIREMENTS 

The  serial  despooler  task  prints  ASCII  text  with  a  maximum  line  length 
of  132  bytes.  It  will  properly  handle  files  with  all  modes  of  FCS 
carriage  control  (that  is,  standard,  embedded,  and  FORTRAN). 


A. 3  TASK-BUILD  INFORMATION 

The  serial  despooler  task  must  be  built  during  an  RSX-11M  system 
generation  because  the  task  image  file  (PRT.TSK)  is  not  distributed  on 
the  standard  release  kits.  Normally,  the  serial  despooler  is  built  to 
retain  all  files  that  have  been  spooled,  but  the  serial  despooler 
build  file  can  be  edited  during  system  generation  to  enable  the 
automatic  delete  feature.  (Note  also,  that  a  nondeleting  despooler 
can  be  made  to  delete,  if  the  data  block  mentioned  in  Section  B.l  and 
shown  in  Figure  A-l  has  a  negative  value  in  word  7.)  When  the  serial 
despooler  is  built  without  automatic  delete,  spooled  files  are 
retained  after  printing.  If  the  system  has  a  deleting  serial 
despooler,  all  spooled  files  are  deleted  after  printing. 
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See  the  RSX-11M  System  Generation  and  Management  Guide  for  detailed 
system  generation  information . 

WORD 


1 

File  name 

2 

in 

3 

RADIX-50 

4 

File  type  in  RADIX-50 

5 

File  version  (binary) 

6 

Device  name  in  ASCII 

7 

Unit  number  (binary) 

8 

9 

File  ID 

10 

11 

12 

Directory  ID 

13 

Figure  A-l  PRT  Send  Data  Buffer  Format 


The  serial  despooler  is  set  to  spool  files  to  LPO : .  It  uses  LUN3  as 
the  spool  device.  The  system  manager  can  redirect  print  files  to  any 
record-oriented  device  (that  is ,  a  device  similar  to  the  printer)  hy 
reassigning  LUN3 .  See  the  RSX-11M/M-PLUS  MCR  Operations  Manual  for 
information  on  the  REASSIGN  command • 


A. 4  PRT  ERROR  MESSAGES 

All  error  messages  issued  by  PRT  are  sent  to  the  console  terminal 
through  pseudo-device  CO:.  The  error  messages  have  the  following 
format : 

PRT  —  text 

All  messages  (except  for  the  receive  failure  error)  supply  information 
that  identifies  the  sender  task  and  the  file  in  question.  All  PRT 
errors  are  fatal;  once  an  error  is  detected,  PRT  terminates  printing 
of  the  input  file,  and  a  cleanup/restart  procedure  is  entered. 

In  the  case  of  the  receive  failure  error,  the  sender  and  file 
information  are  unavailable.  Furthermore,  PRT  does  not  attempt  to 
dequeue  additional  spool  requests  because  of  the  nature  of  this  error 
condition.  Instead,  PRT  exits  causing  its  receive  queue  to  be  purged 
by  the  system. 

RECEIVE  FAILURE,  d.  —  TASK  EXITING 

Explanations  The  Receive  Data  or  Exit  directive  failed  while 
attempting  to  obtain  the  next  file  specifier  from  the  queue.  The 
system  error  code  (d.)  is  printed  to  identify  the  error. 
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NO  DEVICE  NAME  —  SENDER:  task  FILE:  f ilename • typ; ver 

Explanation:  The  dequeued  print  request  did  not  contain  a  device 
name . 

NO  FILE  ID  —  SENDER:  task  FILE:  filename . typ ; ver 

Explanation:  The  dequeued  print  request  did  not  contain  a  file 

ID. 


OPEN  FAILURE  INPUT  FILE  -  SENDER:  task  FILE:  filename . typ ? ver ,  d. 

Explanation:  The  specified  file  could  not  be  opened.  One  of  the 

following  six  conditions  may  exist: 

1.  The  file  is  protected  against  access  for  read  privileges. 

2.  A  problem  exists  on  the  physical  device  (for  example,  device 
cycled  down) . 

3.  The  volume  is  not  mounted. 

4.  The  specified  file  directory  does  not  exist. 

5.  The  named  file  does  not  exist  in  the  specified  directory. 

6.  The  file  is  already  deleted. 

The  system  error  code  (d.)  is  printed  to  identify  the  failure. 
ATTACH  FAILURE  —  SENDER:  task  FILE:  filename . typ; ver ,  d. 
or 

DETACH  FAILURE  —  SENDER:  task  FILE:  filename • typ ; ver ,  d. 

Explanation:  The  line  printer  could  not  be  attached/detached 

(that  is,  the  system  does  not  contain  a  line  printer).  The 
system  error  code  (d.)  is  printed  to  identify  the  error. 

PRINT  ERROR  —  SENDER:  task  FILE:  filename • typ ; ver ,  d. 

Explanation:  A  Queue  I/O  request  to  the  line  printer  has  failed. 

The  system  error  code  (d.)  is  printed  to  identify  the  error. 

I/O  ERROR  INPUT  FILE  -  SENDER:  task  FILE:  filename . typ; ver ,  d. 

Explanation:  An  error  was  detected  while  reading  the  input  file. 

One  of  the  following  three  conditions  may  exist: 

1.  A  problem  exists  on  the  physical  device  (for  example,  device 
cycled  down) . 

2.  The  length  of  the  text  line  is  greater  than  132  bytes. 

3.  The  file  is  corrupted  or  the  format  is  incorrect. 

The  system  error  code  (d.)  is  printed  to  identify  the  error, 
d.  LINES  WERE  TRUNCATED 

Explanation:  While  printing  the  file,  PRT  truncated  d.  lines. 
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RSX-11M/M-PLUS  UFD  CONVENTIONS 


The  RSX-11M  and  RSX-11M-PLUS  operating  systems  observe  a  set  of  User 
File  Directory  (UFD)  conventions  for  files  on  disk.  These  conventions 
provide  a  consistent  method  of  locating,  allocating,  and  maintaining  a 
file  on  disk.  3 


A  UFD  is  itself  a  file,  named  in  the  format  gggmmm.DIR  where  g  and  m 
are  octal  numbers  in  the  range  1  through  377  (0  is  reserved).  The 
numbers  represent  the  file  owner's  group  and  member  number 
respectively.  For  more  information  on  file  ownership  and  directories, 
see  the  RSX-11M/M-PLUS  MCR  Operations  Manual,  the  RSX-11M  Command 
Language  Manual,  and  the  RSX-11M-PLUS  Command  Language  Manual.  - 

The  usage  of  certain  UFDs  is  common  to  both  operating  systems;  other 
UFDs  are  specific  to  the  RSX— 11M  or  RSX-11M-PLUS  operating  systems. 
The  following  sections  describe  group  and  member  numbers  and  their  use 
in  identifying  the  contents  of  system  UFDs.  A  section  on  file  naming 
conventions  is  also  included. 


B . 1  GROUP  NUMBER 

The  group  number  identifies  groups  of  directories.  By  convention, 
group  numbers  1  through  200  are  reserved  by  DIGITAL  for  system  files, 
and  group  numbers  201  through  377  are  reserved  for  user  files.  The 
group  numbers  may  vary  between  RSX-11M  and  RSX-11M-PLUS .  Table  B-l 
lists  the  group  numbers  and  their  usage. 


Table  B-l 

Group  Number  Identification 


Group  Number 

Usage 

11 

Executive  files 

12 

MCR  files 

13 

FCP  files  ( RSX— 1 1M-PLUS ) 

14 

RMD  files 

15 

Privileged  utility  tasks 

23 

DCL  files 

(continued  on  next  page) 
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Table  B-l  (Cont.) 

Group  Number  Identification 


Group  Number 

Usage 

25 

Queue  Manager  files 

27 

On-line  configuration  (RSX-11M-PLUS ) 

45 

K-Series  files 

50 

FCS  files 

121 

Line  printer  despooler  (RSX-11M-PLUS ) 

125 

Shadow  Recording  (RSX-11M-PLUS) 

126 

Accounting  tasks  (RSX-11M-PLUS ) 

200 

SYSGEN  Indirect  command  files 

B .  2 

MEMBER  NUMBER 

The 

second  number 

(member  number)  identifies  the  different  file  types 

within  each  group. 

Table  B-2  lists  the  member  numbers. 

Table  B-2 

Member  Number  Identification 


Member  Number 

File  Types 

10 

Source  modules 

20 

Object  modules,  assembly  and  task-build 
command  files,  and  object  module  libraries 
for  RSX-11M  nonprivileged  tasks  and 
RSX-11M/M-PLUS  build  files 

24 

Object  modules,  assembly  and  task-build 
command  files,  and  object  module  libraries 
for  the  RSX-11M/M-PLUS  Executive  and  for 
privileged  and  nonprivileged  tasks  on 
RSX— 1 1M-PLUS 

30 

RSX-11M  unmapped  system  listing  and  map 
files  for  privileged  and  nonprivileged 
tasks 

34 

RSX-11M-PLUS  and  RSX-11M  mapped  system 
listings  and  map  files  for  privileged  and 
nonprivileged  tasks 

40 

SLP  correction  files  for  files  located 
under  member  number  10 

50 

RSX-11M  unmapped  system  image  and  task 
image  files 

(continued  on  next  page) 
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Table  B-2  (Cont.) 

Member  Number  Identification 


Member  Number 

File  Types 

54 

RSX-11M-PLUS  and  RSX-11M 
image  and  task  image  files 

mapped 

system 

60 

RSX-11S  unmapped  system 
correction  files  applied 
system  image  and  task  image 

SLP  and  PAT 
by  Update,  and 
files 

64 

RSX-11S  mapped  system  image 
files 

and  task 

image 

200 

SYSGEN  Indirect  command  files 

B . 3  EXAMPLE  SYSTEM  USER  FILE  DIRECTORIES 

The  system  UFDs  consist  of  a  group  number  and  a  member  number.  These 
numbers  identify  the  specific  contents  of  each  directory.  For 
example ,  if  you  wanted  to  locate  all  the  MCR  listing  and  map  files, 
you  could  find  the  group  number  for  MCR  files  (12)  and  the  member 
number  for  listing  and  map  files  (34)  and  combine  them  to  specify  the 
UFD  [12,34];  this  UFD  contains  the  MCR  listing  and  map  files. 
Table  B-3  lists  the  MCR  UFDs  and  the  files  contained  in  each  UFD. 
Table  B-4  lists  the  UFDs  used  by  the  RSX-11M/M-PLUS  operating  system. 


Table  B-3 

MCR  User  File  Directories  (UFDs) 


[12,10] 

MCR  source  files 

[12,20] 

Unmapped  MCR  object  modules,  assembly 
command  files,  and  library  build  command 
file 

[12,24] 

Mapped  MCR  object  modules,  assembly  command 
files,  and  library  build  command  file 

[12,30] 

Unmapped  MCR  listing  and  map  files 

[12,34] 

Unmapped  MCR  listing  and  map  files 

[12,40] 

SLP  correction  files  for  files 

[12,10] 

under 

Table  B-4 
System  UFDS 


[1/1]  System  and  macro  object  module  libraries 

[1/2]  System  message  and  help  files 

[1/3]  Lost  files  found  by  VFY 

(continued  on  next  page) 
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Table  B-4  (Cont.) 
System  UFDS 


Cl, 4] 

Postmortem  and  snapshot  dumps 

[1,6] 

Error  logging  files  and,  on  RSX-11M-PLUS , 
Accounting 

[1,7] 

Spooling  queue  file  and  transparent  listing 
file 

[1,11] 

RSX-11M-PLUS  work  space  for  system 

maintenance 

[1,20] 

RSX-11M  object  module  libraries  and 
task-build  overlay  descriptor  files  for 
nonprivileged  tasks 

[1,24] 

Object  module  libraries,  task-build  command 
files  for  mapped  tasks,  and  overlay 
descriptor  files  for  privileged  tasks 

[1,34] 

Executive  and  task  maps 

[1,54] 

Executive  and  system  tasks 

[2,300] 

UETP  files 

[200,1] 

Sample  files  for  system  introduction 

[200,2] 

Field  service  files 

B . 4  SYSTEM  FILE-NAMING  CONVENTIONS 

System  file  names  have  the  following  general  format: 
nnnsss . typ 


where : 

nnn 


sss 


typ 


The  system  identification  for  the  task, 
is  the  identification  for  the  File  Dump 


For  example,  DMP 
Utility  Program. 


A  suffix  for  noting  the  relationship  of  the  file  to  the 
task  specified  in  the  nnn  identification.  For  example, 
PIPBLD.CMD  is  the  command  file  for  building  PIP. 


Suffixes : 

ASM  -  Assembly  command  file 

BLD  -  Task  Builder  command  or  overlay  descriptor 
file 

RES  -  FCSRES  version  of  the  task 

FSL  -  FCSFSL  version  of  the  task  ( RSX-11M-PLUS ) 

The  standard  mnemonic  for  file  type.  RSX-11M/M-PLUS  has 
a  set  of  conventional  and  default  file  types  that  are 
used  to  reflect  the  contents  of  a  file.  See  Table  B-5 . 


B-4 


RSX-11M/M-PLUS  UFD  CONVENTIONS 


Table  B-5 

System  File  Types 

Type 

File  Contents 

.BAS 

BASIC-11  language  source  file 

.BAT 

Batch  file 

.BLD 

Indirect  command  file  used  as  input  to  SYSGEN 

.  B2S 

BASIC-PLUS-2  language  source  file 

.  CBL 

COBOL  language  source  file 

.  CDA 

Crash  dump  binary  file 

.  CFS 

Error  logging  control  file  string 

.  CLB 

Indirect  Command  Processor  command  file  library 

.CMD 

Indirect  command  file 

.COR 

SLP  correction  file 

.CRF 

Cross-Reference  Processor  symbol  table  file 

.DAT 

File  containing  data  (as  opposed  to  a  program) 

.DIR 

Directory  file 

.  DMP 

File  Dump  Utility  output  file 

.ERR 

Error  Logger  output  file 

.  FTN 

FORTRAN  IV,  FORTRAN  IV-PLUS  or  FORTRAN  77  language 
source  file 

.  HLP 

Help  file 

.LOG 

Batch  or  console  log  file 

•  LST 

Listing  file 

.MAC 

MACRO-11  source  file 

.MAP 

Task  Builder  memory  allocation  map 

.MLB 

Macro  library  file 

.OBJ 

Object  module  (output  from  either  the  MACRO-11 
Assembler  or  a  compiler)  file 

.  ODL 

Task  Builder  overlay  descriptor  file 

•  OLB 

Object  module  library  file 

.PAT 

PAT  Utility  Correction  file 

.POB 

Patched  object  module  used  by  the  PAT  Utility 

(continued  on  next  page) 
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Table  B-5  (Cont.) 
System  File  Types 


Type 

File  Contents 

.  SML 

System  macro  library  file 

.STB 

Task  symbol  table  file 

.SYS 

Bootable  system  image  or  other  system  file 

.  TMP 

Temporary  file 

.TSK 

Task  image  file 

.TXT 

Text  file 

.  ULB 

Universal  library  file 

B-6 


INDEX 


/ABAUD  keyword  ( VMR) ,  10-53 
ABORT  command 
IOX,  4-24 

Shadow  Recording,  18-7 
Account  File  Maintenance  Program 
See  ACNT 

Accounting  Startup  Transaction 
Block,  17-25 
ACNT,  1-1,  2-1 
Account  entry 
contents,  2-1 
deleting,  2-9 
examining,  2-5 
listing,  2-8 
modifying,  2-7 
Account  file 

maximum  number  of  entries, 

2-3 

sorting,  2-10 
account  file 
copying,  2-3 
extending,  2-3 
changing  password,  2-1 
copying  account  file,  2-3 
error  messages,  2-11 
ESCAPE  key,  2-3 
invoking,  2-2 
options,  2-2 
Add,  2-3 
Create,  2-3 
Delete,  2-9 
Examine,  2-5 
Exit,  2-11 
List,  2-8 
Modify,  2-7 
Sort,  2-10 

password  encryption,  2-1 
protection 

restoring,  2-3 
ACSUB ,  17-17 
Activity  report 
IOX,  4-20,  4-42 
Add  option 
ACNT,  2-3 

/AFF  keyword  (VMR),  10-22,  10-54 
Allocate  Device  Transaction  Block 
17-27 

ALT 

See  ALTER  command  (VMR) 

ALTER  command  (VMR) ,  10-8 
definition,  10-8 
example,  10-8 
format,  10-8 
keyword 

/PRI,  10-8 
parameters,  10-8 
/ANSI  keyword  (VMR) ,  10-54 
ASN 

See  ASSIGN  command  (VMR) 


ASSIGN  command  (VMR) ,  10-9 
definition,  10-9 
examples,  10-10 
formats,  10-9 
keywords 

/GEL,  10-10 
/SYSTEM,  10-10 
parameters,  10-9 
ASSIGN/QUEUE  command 
DCL ,  7-9 
MCR ,  7-9 

/AVO  keyword  (VMR) ,  10-54 


Backus-Naur  Form  metalanguage, 
12-6 

Bad  block 

bad  block  replacement  functions 
5-1 

detection,  5-1,  5-3 
handling 

MSCP  disks,  5-3 
listing 
IOX,  4-26 

notification,  5-1,  5-3 
recovery  techniques,  5-1 
removing  from  testing 
IOX,  4-25 

replacement,  5-1,  5-3  to  5-4 
partial,  5-4 
revectoring,  5-1,  5-4 
specifying 
IOX,  4-25 

Bad  Block  Replacement  Control 
Task,  1-2 
See  also  RCT ,  5-1 
BADBLOCKS 

display  command,  4-26 
IOX  command,  4-25 
parameter  command,  4-25 
Base  priority  for  nonpr i vi leged 
tasks,  13-13 
Batch  processing,  7-1 
Batch  processor 

initialization,  7-11 
DCL  command,  7-11 
MCR  command,  7-11 
installation,  7-9  to  7-10 
Batch  processor  prototype  task 
See  BPR 

Batch  queue,  7-12 
assignment 

DCL  command,  7-13 
MCR  command,  7-13 
BC,  12-27 
BCT ,  12-28 
Bit  Clear 
See  BC 

Bit  Clear  Test 
See  BCT 
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Bit  Set 
See  B 

Bit  Set  Test 
See  BST 

/BLKMOD  keyword  (VMR) ,  10-55 
/BOOT  keyword  (VMR) ,  10-47 
/BOT  keyword  (VMR) f  10-55  to 
10-56 
BPR ,  7-2 
BPR.TSK,  7-10 
/BRO  keyword  (VMR) ,  10-56 
BS,  12-27 
BST ,  12-28 

/BUF  keyword  (VMR) ,  10-57 
Buffer  space 
statistics 

with  PARAMETERLIST ,  4-44 
BUFFERS I ZE  command 
IOXf  4-27 

BUILD  command ,  15-7 
CAN 

See  CANCEL  command  (VMR) 

CANCEL  command  (VMR) ,  10-11 
definition,  10-11 
example,  10-11 
format,  10-11 
parameter,  10-11 

Card  Reader  Spooling  Transaction 
Block,  17-31 
CBM,  12-29 
Checkpoint 

dynamic  common  regions,  14-1 
static  common  regions,  14-1 
tasks,  14-1 
Checkpointable  task 
fixing,  10-18 

Checkpointing,  10-22,  10-28 
common,  10-28 
/CKP  keyword  (VMR) ,  10-22 
CLEAR  command,  15-8 
CLI,  1-3,  11-1,  11-3 

adding  to  account  entry,  2-3 
changing,  2-7 
continuation  lines,  11-8 
displaying,  2-5,  2-8 
examples,  11-11,  11-16 
FORTRAN,  11-16,  11-20 
MACRO-11,  11-11,  11-15 
Executive  directives,  11-3 
in  account  entry,  2-1 
interaction  with  system,  11-3 
MCR ,  2-3,  11-2 

mult i-CLI  support,  2-1,  2-3, 

2-7 

prompting,  11-7  to  11-8 
prompts 

CTRL/C,  11-7 
task-exit,  11-8 
See  Command  Line  Interpreter, 
10-23 

serial  command  processing,  11-8 
system  messages  to,  11-5 
task  names,  11-4 


CLI  (Cont.) 

writing,  11-2  to  11-3 
CLI  dispatcher  task,  12-5 
/CLI  keyword  (VMR) ,  10-23 
CO:,  3-1 

as  pseudo  device,  3-1 
attaching,  3-3 
detaching,  3-3 
monitoring  status,  3-6 
reading  from,  3-3 
redirecting,  3-7 
CODRV ,  3-1 
Command  (VMR) 

See  also  VMR  commands 
comments  in,  10-5 
components  of,  10-4 
file  specifications,  10-5 
keyword,  10-4 
keyword  value,  10-5 
name,  10-4 
parameter,  10-4 
Command  format  (VMR) ,  10-4 
Command  Language  Interpreters, 

1-3 

Command  line 

comments,  10-5 
file  specifications,  10-5 
format,  10-4 
rejected,  10-94 
Command  Line  Interpreter 
See  CLI 
task,  10-23 

Command  syntax  (VMR) ,  10-4 
abbreviating  commands,  10-4 
command  keywords,  10-4 
command  line  format,  10-4 
command  names,  10-4 
command  parameters,  10-4 
entering  comments,  10-5 
keyword  values,  10-5 
Common 

checkpointing ,  10-28 
directive 

fixing,  10-19 
partition,  14-1 
protecting,  10-25 
synchronizing  task  use,  10-27 
task  sharing,  10-27 
unfixing,  10-92 
COMPAREDATA  YES/NO  command 
IOX,  4-28 

Compatibility  mode 
See  VAX-11  RSX 
CON 

see  CONFIGURATION  command  (VMR) 
command  descriptions,  15-7, 
15-30 

error  messages,  15-39,  15-41 
format,  15-39 
invoking,  15-4 

indirect  command  files,  15-4 
CON  command  summary,  15-5 
CON  commands 

BUILD,  15-5,  15-7 


Index-2 


CON  commands  (Cont.) 

CLEAR,  15-5 
DISPLAY,  15-5,  15-9 
ESTATUS,  15-5,  15-12 
HELP,  15-5,  15-14 
IDENT,  15-5,  15-15 
LINK,  15-5,  15-16 
LIST,  15-5,  15-17 
OFFLINE,  15-5,  15-19 
OFFLINE  MEMORY,  15-22 
ONLINE,  15-6,  15-23 
ONLINE  MEMORY,  15-26 
SET,  15-6,  15-27 
SWITCH,  15-6,  15-29 
UNLINK,  15-6,  15-30 
Configuration 

of  devices  in  IOX,  4-29 
CONFIGURATION  command  (VMR) , 
10-12 

definition,  10-12 
examples,  10-13,  10-16 
formats,  10-12 
keywords 

CONTROLLERS,  10-13 
CPU,  10-13 
FULL,  10-13 
UNITS,  10-13 
parameters,  10-12 
CONFIGURE  command 
IOX,  4-29 

Console  Logger,  1-1,  3-1 
communication  with,  3-2 
task  communication,  3-2 
user  communication,  3-2 
Console  Logging 
CO: 

writing  to,  3-2 
commands,  3-3 
error  messages,  3-11 
installing  COT...,  3-2 
loading  CODRV,  3-2 
log  file 

disabling,  3-5 
reassigning,  3-5 
multiple  commands,  3-6 
reading  log  file,  3-8 
sample  session,  3-8 
starting,  3-4 
stopping,  3-4 
Console  Output  Device 
See  CO:,  3-1 
Console  terminal 
disabling,  3-5 
display,  3-4 
reassigning,  3-5 
Continuation  line 
CLI,  11-8 
CONTINUE  command 

Shadow  Recording,  18-8 
Contradictory  Bit  Mask 
See  CBM,  12-29 
Control 

IOX  command 
category,  4-3 


CONTROL_C  command 

CONTROL__C  YES/NO  command 
IOX,  4-32 
IOX 

effect  on  CTRL/C,  4-32 
CONTROL_P 
See  CTRL/P 

Controller  failures,  15-34 
COP,  12-30 
COPY  command,  9-7 
COT...,  3-1 

Crash  Recovery  Transaction  Block, 
17-25 

Create  option 
ACNT ,  2-3 

/CRT  keyword  (VMR) ,  10-57 
/CTB  keyword  (VMR) ,  10-33 
CTRL/C  command 

See  CONTROL_C  command,  4-32 
CTRL/P,  9-3,  9-7 


Data  terminal  emulation 
See  DTE,  9-1 
Data  Terminal  Emulator 
See  DTE 
see  DTE 
Date 

displaying,  10-90 
setting,  10-90 
DCL,  11-2,  11-5,  11-8 
building,  12-1 

conventional  installation,  12-2 
deleting  files,  9-7 
IFORM ,  12-24 
installation ,  12-1 
alternatives ,  12-2 
catchall  task,  12-3 
MCR  task,  12-3 
intermediate  form 
See  IFORM 

MCR  fallthrough,  12-4 

parser  process,  12-5 

parser  table  example,  12-21 

SET  commands,  12-3 

task,  12-3 

task  building,  12-4 

task-building 

first  task  build,  12-4 
second  task  build,  12-5 
telephone  number 
specifying,  9-4 
terminal  emulation 
specifying,  9-3,  9-5 
transferring  files,  9-7 
translator  process,  12-5 
DCL  command  table,  12-7 
constructing ,  12-6 
example,  12-46,  12-48 
interpreting ,  12-18 
modifying,  12-8 
DCL  commands 

interpretation ,  12-5 
mapping  to  MCR,  12-21 
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DCL  Master  Command  Table 
See  DCL  MCT 
DCL  MCT ,  12-9 
DCL  QMG  commands 
DCL  task,  1-4,  12-5 

adding  commands,  12-8 
definition,  12-1 
deleting  commands,  12-13 
modifying  commands,  12-13 
overlay,  12-10 
PT/TT,  12-12 
file,  12-9 

Deallocate  Device  Transaction 
Block,  17-28 

/DEC  keyword  (VMR) ,  10-57 
DECnet  Remote  Terminal  Facility 
See  RMT 
DECtape 

exercising 
IOX,  4-2 
Default  (VMR) 
device,  10-5 
directory,  10-6 
file  name,  10-6 
file  types,  10-6 
version  number,  10-6 
DELETE  command,  9-7 
Delete  option 
ACNT ,  2-9 

DELETE/REMOTE  command,  9-7 
/DENS  keyword  (VMR) ,  10-48 
Density 
tape 

in  IOX,  4-33 
DENSITY  command 
IOX,  4-33 
DESELECT  command 
IOX,  4-35 

Despool  prototype  task 
See  LPP 
DEV 

See  DEVICES  command  (VMR) 

DEV  command 

disk  data  caching,  19-15 
Device 

exercising 

examples 

RL02,  4-10 

IOX 

adding,  4-29 
displaying,  4-29 
exercising 
steps,  4-2 

status  during  exercise,  4-60 
testing 

removing,  4-35 
time  of,  4-57 
null,  10-39 
offline,  10-17 
placing  off  line,  15-3 
placing  on  line,  15-3 
pseudo,  10-3 
redirecting ,  10-39 

redirecting  restrictions,  10-39 


Device  (Cont.) 
removing,  10-93 

removing  attached  device,  10-93 
system  default 

adding  to  account  entry,  2-3 
changing,  2-7 
displaying,  2-5,  2-8 
in  account  entry,  2-1 
Device  context,  15-3 
Device  Statistics  Block,  17-31 
Device  statistics  example 
Resource  Accounting,  17-7 
Device  unit  failures,  15-34 
DEVICES  command  (VMR) ,  10-16 
def ini t ion ,  10-16 
example,  10-16 
format,  10-16 
notes,  10-17 
parameter,  10-16 
Diagnostic  error  message,  10-94 
Diagnostics  Loader  task 
See  DLD 

Digital  Command  Language 
See  DCL 
task,  12-1 

DIR  attribute,  12-31 
/DIR  keyword  (VMR) ,  10-19 
Disk 
block 

random  or  sequential 
IOX,  4-51 

testing  range  display 
IOX,  4-52 

testing  range  for  NFS  volumes 
IOX,  4-52 
exercising 
examples 
RL02 

IOX,  4-10 
IOX,  4-2 

exercising  (IOX) 
examples 

NFS  volume,  4-15 
Files-11 

parameter  commands 
IOX,  4-8 
testing 

IOX,  4-63 
testing 

selecting  random  testing 
IOX,  4-51 
skipping  blocks 
IOX,  4-41 

Disk  Data  Caching,  1-5,  19-1 
Data  Cache  Manager,  19-3 
DCL  commands,  19-6,  19-10 
features,  19-1 
I/O  operations,  19-1 
including  in  system,  19-1,  19-3 
MCR  commands,  19-10,  19-16 
options,  19-7,  19-10 
region,  19-3 

Dismount  Device  Transaction  Block, 
17-29 
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Display 

IOX 

bad  blocks  list,  4-26 
commands  as  a  category,  4-3 
continuing 

with  PROCEED,  4-50 
status  during  exercise,  4-60 
DISPLAY  command,  15-9 
Shadow  Recording,  18-9 
DLD ,  15-36 

how  to  use,  15-36,  15-39 
DMAP  attribute,  12-32 
DTE,  1-3,  9-1 
Dynamic  common  region 
checkpointing ,  14-3 
shuffling,  14-6 

/EEC  keyword  ( VMR) ,  10-57 
/ECHO  keyword  (VMR) ,  10-58 
Echo  loops,  9-4 
/EDIT  keyword  (VMR) ,  10-58 
ERR  attribute,  12-31 
Error  limit 
altering 
IOX,  4-36 

Error  Logger,  15-32 
Error  message  format,  10-94 
Error  messages 
IOX,  4-68 

Error  messages  (VMR) ,  10-94, 
10-112 

diagnostic,  10-94 
fatal,  10-94 
format,  10-94 
unmarked,  10-94 
Error  report 
data  compare 
IOX,  4-21 

directing  to  device 
IOX,  4-42 
disabling 
IOX,  4-54 
enabling 
IOX,  4-54 
I/O  error 
IOX,  4-22 
types 

IOX,  4-54 

ERRORLIMIT  command 
IOX,  4-36 
ESCAPE  key 

requesting  list  of  options 
ACNT ,  2-3 

/ESCSEQ  keyword  (VMR) ,  10-58 
ESTATUS  command,  15-12 
Event  flag  s 
IOX,  4-66 
Examine  option 
ACNT,  2-5 
EXECUTE  command 
IOX,  4-37 
Execution 

termination  of  task 
IOX,  4-24 


Execution  mode 
entering 
IOX,  4-61 
IOX,  4-18 

Executive  data  space  support, 

10-3 

Executive  pool  monitor  code,  13-1 
EXIT  command 
IOX,  4-38 
Exit  option 
ACNT,  2-11 

Fast-mapping ,  10-23 
Fatal  error  message,  10-94 
Fault  isolation,  15-33 
/FDX  keyword  (VMR) ,  10-59 
File 

See  also  Account  file 
copying 

See  also  File  transferring 
transferring,  9-1,  9-3,  9-5, 

9-8 

Professional  Personal 

Computer  systems,  9-1 
VAX-11  RSX  systems,  9-1,  9-5 
File  size 

specifying  in  blocks,  4-63 
File  specification  (VMR) 
components,  10-5 
defaults,  10-5 
device  name,  10-5 
directory,  10-6 
file  name,  10-6 
file  type,  10-6 
format,  10-5 
/IM  switch,  10-7 
named  directory,  10-6 
specifying,  10-5 
version  number,  10-6 
File-structured  device 
exercising 
IOX,  4-3 
Files-11 
disk 

selecting  for  testing 
IOX,  4-39,  4-65 
volume 

protecting  with  TEMPORARYFILE 
IOX,  4-63 
volume  exercise 
example 
IOX,  4-10 
Files-11  volume 
selecting,  4-7 
FILES11  command 
IOX 

default  parameters,  4-39 
FIX  command  (VMR) ,  10-18 
definition,  10-18 
examples,  10-19 
format,  10-18 
keywords 

/DIR,  10-19 
/NSF ,  10-19 
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FIX  command  (VMR) 
keywords  (Cont . ) 

/REG,  10-19 
/RON,  10-19 
parameter,  10-18 
/FIX  keyword  (VMR) ,  10-23 
FIX-IN-MEMORY  command 
See  FIX  command  (VMR) 

Fixing 

directive  common,  10-19 
Flying  installs,  12-4 
/FMAP  keyword  (VMR) ,  10-23 
/FORMFEED  keyword  (VMR) ,  10-59 
Full-duplex  terminal  driver, 

10-50 

GET/SET  option,  10-50 
Function  commands 
IOX  category,  4-3 

/GBL  keyword  (VMR) ,  10-10 

Hard  errors,  15-32 
Hardware  faults,  15-31 

intermittent  failures,  15-32 
media  failures,  15-31 
transient  failures,  15-31 
HELP  command,  15-14 
IOX,  4-40 

/HFILL  keyword  (VMR) ,  10-59 
/HHT  keyword  (VMR) ,  10-59 
High  pool,  13-3  to  13-4 
High  pool  event,  13-2 
HLP  attribute,  12-32 
HRC ,  15-2 

error  messages 
format,  15-39 

HRC  error  messages,  15-41,  15-44 
/HSYNC  keyword  (VMR) ,  10-60 

I/O  error  report 
IOX,  4-22 
I/O  exercise 
steps,  4-2 
termination,  4-24 
I/O  Exerciser 
See  IOX 

I/O  Queue  Optimization,  1-5,  16-1 
Cylinder  Scan,  16-1,  16-4 
default,  16-3 
Elevator,  16-1 
Elevator  Method,  16-4 
error  messages,  16-4 
fairness  count 

adjustment,  16-3 
Fa irnesscount ,  16-1 
initiating,  16-1 
Nearest  Cylinder,  16-1,  16-4 
optimization  status,  16-2 
optimization  types,  16-1 
selecting  method,  16-3 
IDENT  command,  15-15 
IFORM ,  12-24 
/IM  switch  (VMR) 

definition,  10-7,  10-47 


/IM  switch  (VMR)  (Cont.) 
relationship  to  symbol 

definition  file,  10-7 
uses,  10-7 

/INC  keyword  (VMR) ,  10-24 
Indirect  command  file 
IOX,  4-6 

Indirect  Command  File  (VMR) ,  10-3 
levels  allowed,  10-4 
specifying,  10-4 
VMR  requirements,  10-3 
INS 

See  INSTALL  command  (VMR) 
INSTALL  command  (VMR) ,  10-21 
definition,  10-21 
examples,  10-30  to  10-31 


format , 

10-21 

keywords 

/AFF, 

10-22,  : 

/CKP , 

10-22 

/CL  I, 

10-23 

/FIX, 

10-23 

/FMAP 

,  10-23 

/INC, 

10-24 

/IOP, 

10-24 

/PMD , 

10-25 

/PR  I, 

10-25 

/PRO, 

10-25 

/RON, 

10-26 

/ROPAR,  10-26 

/SEC, 

10-27 

/SLV, 

10-27 

/SYNC 

,  10-27 

/TASK 

,  10-27 

/UIC, 

10-28 

/WB, 

10-28 

/XHR , 

10-28 

notes , 

10-31  to 

parameters,  10-21 

Interactive  mode 
IOX,  4-19 

INTERLEAVE  command 
IOX,  4-41 

Intermittent  failures,  15-32 

Interval  report 
IOX,  4-20 

Invalid  Login  Transaction  Block, 
17-27 

/IOP  keyword  (VMR) ,  10-24 

IOX,  1-1 
command 

LOOPBACK,  4-43 
parameter  list 

for  Files-11,  4-8 
command  mode,  4-18 
commands 

ABORT,  4-24 
BADBLOCKS,  4-25 
BUFFERSIZE,  4-27 
categories,  4-3 
COMPAREDATA  YES/NO,  4-28 
CONFIGURE,  4-29 
CONTROL_C  YES/NO,  4-32 
CTRL/C,  4-31 
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IOX 

commands  (Cont.) 

DENSITY,  4-33 
descriptions,  4-22 
DESELECT,  4-35 
ERRORLIMIT,  4-36 
EXECUTE,  4-37 
EXIT,  4-38 
files,  4-6 
FILES11 ,  4-39 
HELP,  4-40 

in  interactive  mode,  4-19 
INTERLEAVE,  4-41 
LOGFILE,  4-42 
parameter 

by  device  type,  4-9 
with  FILES11,  4-8 
with  SELECT,  4-9 
with  VERIFY,  4-9 
parameter  list 

for  NFS  volumes,  4-9 
PARAMETERLIST,  4-44 
PATTERN,  4-48 
PR I NTS  UMMAR Y ,  4-49 
PROCEED,  4-50 
RANDOM,  4-51 
RANGE,  4-52 
RECORDS,  4-53 
REPORTERRORS  YES/NO,  4-54 
RESTART,  4-55 
RETRIES,  4-56 
RUNTIME,  4-57 
SELECT,  4-58 
SPY,  4-60 
START,  4-61 
SUMMARYTIME,  4-62 
syntax,  4-22 
TEMPORARYFILE,  4-63 
VERIFY,  4-64 
VOLUMECHECK,  4-65 
WAIT,  4-66 
WRITECHECK,  4-67 
considerations  for,  4-1 
controlling  with  CTRL/C,  4-32 
data 

compare  error  report,  4-21 
pattern  checking,  4-28 
transfer  size  of,  4-27 
DECtape  exercising,  4-2 
defaults 

changing  during  task  build, 
4-22 

device 

exercising  steps,  4-2 
status  display,  4-60 
testing 

time  of,  4-57 
disk  exercising,  4-2 
error  messages,  4-68 
execution  mode,  4-18 
entering,  4-18 
exercise  parameters 
general  list,  4-8 
exiting,  4-38 


IOX  (Cont.) 

file-structured  exercising,  4-3 
increment,  4-5 
indirect  command  files,  4-6 
installation 

on  RSX-llM ,  4-4 
on  RSX-1 1M-PLUS ,  4-4 
interleaving  with  Executive, 
4-66 

interval  report  output 
frequency,  4-62 
invoking 

on  RSX-llM,  4-5 
on  RSX-llM -PLUS ,  4-5 
when  installed,  4-5 
when  not  installed,  4-5 
with  an  increment,  4-5 
without  an  increment,  4-5 
nonfile-structured  exercising, 
4-3 

output  type 

activity  report,  4-20 
interval  report,  4-20 
summary  report,  4-20 
parameter 

command  exercising  magnetic 
tape,  4-12 
exercising 

device-dependent  exercise, 
4-8 

Files-11  volumes,  4-10 
NFS  volume,  4-15 
general  list  of  exercise 
parameters,  4-8 
overriding  default 
FILES11,  4-39 
SELECT,  4-58 
showing  default  with 

PARAMETERLIST,  4-44 
parameter  command  category,  4-3 
pattern 

altering  test,  4-48 
displaying  test,  4-48 
restarting,  4-55 
running  steps,  4-1 
selecting 

NFS  volume,  4-8 
starting,  4-61 
task  termination,  4-18 
task-build  file 
location  of,  4-22 
termination,  4-38 
using  PROCEED,  4-50 
test  configuration,  4-29 
adding  units,  4-6 
displaying,  4-6 
setting  up,  4-6 
testing 

removing  devices  from,  4-35 
wai t-for-event  flag,  4-66 
write-check,  4-67 

LBN,  5-2 

/LIBUIC  keyword  ( VMR) ,  10-60 
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/LINES  keyword  (VMR) ,  10-61 
LINK  command ,  15-16 
LIST  command,  15-17 
List  option 
ACNT,  2-8 
LOA 

See  LOAD  command  (VMR) 

LOAD  command  (VMR) ,  10-33 
definition,  10-33 
examples,  10-34 
format,  10-33 
keywords 

/CTB,  10-33 
/PAR,  10-33 
/SIZE,  10-34 
/VEC,  10-34 
notes,  10-34 
parameters,  10-33 
LOGFILE  YES/NO  command 
IOX,  4-42 

Logical  AND,  12-27 
Logical  Block  Number,  10-31 
Logical  blocks 
See  LBN 

LOGICAL  UNIT  NUMBERS  command 
See  LUNS  command  (VMR) 

LOGIN  command,  9-6 
Login  Transaction  Block,  17-30 
/LOGON  keyword  (VMR) ,  10-61 
LOGOUT  command,  9-3,  9-7 
LOOPBACK 

parameter  command,  4-43 
Low  pool,  13-3  to  13-4 
Low  pool  event,  13-2 
/LOWER  keyword  (VMR) ,  10-61 
LPP ,  7-2 
LUN 

See  LUNS  command  (VMR) 

LUNS  command  (VMR) ,  10-35 
definition,  10-35 
example,  10-35 
format,  10-35 
parameter,  10-35 

Macro  Metalanguage 
See  MML 
Magnetic  tape 
density 

displaying  in  IOX,  4-33 
specifying  in  IOX,  4-33 
error  retries,  4-56 
exercise 

example,  4-12 
using  SELECT,  4-12 
records  tested,  4-53 
testing 

altering  record  count,  4-53 
/MAIN  keyword  (VMR) ,  10-61,  10-63 
MAP  attribute 

secondary  mappings,  12-35 
MAP  attributes,  12-33  to  12-34 
Master  Command  Table 
See  MCT 

/MAXEXT  keyword  (VMR) ,  10-63 


MCR ,  11-1  to  11-2 
CLI  default,  2-3 
transferring  files,  9-5,  9-7 
translator  table  example,  12-21 
MCR  CLI  command,  11-5 
MCR  command,  12-3 
MCR  QMG  commands 
MCR  UFDs ,  B-3T 
MCT 

contents,  12-7 
Media  failures,  15-31 
Memory,  14-1 

compacting  space 
See  SHF 

Memory  management 

fixing  tasks,  10-18,  10-23 
Metalanguage ,  12-13 

category  references,  12-14 
exclus i ve-OR ,  12-15 
optional  syntax  indicators, 

12-15 

production  rule,  12-14 
adjective,  12-14 
subject,  12-14 
syntax  tree,  12-14 
MFT,  9-1 

MFT  command,  9-5,  9-7 
Micro/RSX  File  Transfer  Utility 
See  MFT 

MKll  memory  box  failures,  15-35 
MML,  12-16 

features,  12-6  to  12-7 
literals,  12-20 
nonliterals ,  12-19 
parser  functions,  12-20 

handling  of  literals,  12-20 
handling  of  nonliterals, 

12-19 

translator  functions,  12-20 
handling  of  literals,  12-20 
handling  of  nonliterals, 

12-19 
Modify  option 
ACNT,  2-7 

Monitor  Console  Routine 
See  MCR 

Mount  Device  Transaction  Block, 
17-28 

MOUNT/CACHE  command 

disk  data  caching,  19-6,  19-10 
MSCP  disks 

configuration,  5-2 
Multistream  line  printer  spooling, 
7-1 

Mutiprocessor  systems 

stand-alone  maintenance,  15-36 

/NETUIC  keyword  (VMR) ,  10-63 
NFS 

exercise  example,  4-15 
testing  range  of  blocks,  4-52 
volume 

altering  range  of  test  blocks, 
4-52 
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NFS 

volume  (Cont.) 

displaying  range  of  test 
blocks,  4-52 
error  retries,  4-56 
selecting  with  SELECT,  4-58 
selecting  with  VERIFY,  4-64 
NFS  volume 
selecting 

with  VERIFY,  4-8 
NO  attribute,  12-36 
Non-f ile-structured  exercising 
IOX,  4-3 

Nonrecoverable  errors,  15-32 
/NSF  keyword  ( VMR) ,  10-19 
Null  device,  10-39 

OCOP,  12-30 
ODT 

disabling,  9-4 
OFFLINE  command,  15-19 
OFFLINE  MEMORY,  15-22- 
On-Line  Debugging  Tool 
See  ODT 

ONLINE  command,  15-23 
ONLINE  MEMORY,  15-26 
/OPT  keyword  (VMR) ,  10-64 

PAR 

See  PARTITIONS  command  (VMR) 
/PAR  keyword  (VMR),  10-33,  10-64, 
10-66 
Parameter 
IOX 

command  category,  4-3 
exercising 

device-dependent  exercise, 
4-8 

Files-11  volumes,  4-10 
magnetic  tape,  4-12 
NFS  volume,  4-15 
list  of  exercise  parameters, 
4-8 

overriding  default 
FILES 11,  4-39 
SELECT,  4-58 
showing  default  with 

PARAMETERLIST,  4-44 
PARAMETERLIST  command 
IOX,  4-44 

displaying  buffer  space,  4-44 
displaying  defaults,  4-44 
Parameters  (VMR) ,  10-4 
/PARITY  keyword  (VMR) ,  10-66  to 
10-67 

Parser  processing,  12-19 
Partition 

common,  14-1 
common  block,  10-31 
creating,  10-54 
definition,  14-1 
fragmentation ,  14-3 
main,  19-4 
modifying,  10-55 


Partition  (Cont.) 
overriding,  10-24 
region,  10-18 
system-controlled ,  14-1 
type,  10-65 
user-controlled ,  14-1 
PARTITION  command  (VMR) ,  10-36 
definition,  10-36 
example,  10-36 
format,  10-36 

PARTITION  DEFINITIONS  command 
See  PARTITIONS  command  (VMR) 
Partition  display 
contents,  10-36 
symbol  meaning,  10-36 
Password 

adding  to  account  entry,  2-3 
changing,  2-1,  2-7 
characters,  2-3 

contained  in  account  entry,  2-1 
displaying,  2-5,  2-8 
/PASTHRU  keyword  (VMR) ,  10-67 
Pattern 
IOX 

altering  test,  4-48 
displaying  test,  4-48 
PATTERN  command 
IOX,  4-48 

Peripheral  Interchange  Program 
See  PIP  utility 
PIP  utility 
account  file 
copying,  2-3 
extending,  2-3 

PLAS 

fixing  tasks,  10-23 
/PLCTL  keyword  (VMR) ,  10-68 
/PMD  keyword  (VMR) ,  10-25 
PMT ,  1-4 

abortable  tasks,  13-7 
aborting,  13-11  to  13-12 
action,  13-11 
activation,  13-3 
conditions  affecting,  13-3 
controlling  pool  use,  13-11 
defaults 

extreme  fragmentation,  13-6 
high  pool  state,  13-5 
low  pool  state,  13-5 
functions,  13-3 
installation ,  13-3 
messages,  13-8 
output 

example  of  extreme 

fragmentation,  13-9  to 
13-10 

low  pool  state,  13-6 
task-build  options,  13-10 
timing,  13-10 
Pool 

conditions,  13-2 

largest  fragment  increases, 
13-5 
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Pool 

conditions  (Cont.) 

largest  fragment  too  small/ 

13-4 

fragmentation/  13-1 
pool 

definition,  13-1 
Pool  fragment  size,  13-13 
/POOL  keyword  (VMR) ,  10-69 
Pool  limits,  13-12 
high/  13-12 
low,  13-12 
Pool  Monitor  Task 
See  PMT 
See  PMT/  13-1 
Pool  monitoring  interface 
functions/  13-2 
Pool  Monitoring  Support/  1-4 
receiving/  13-1 

/POOLSIZE  keyword  (VMR) ,  10-69 
Predefined  syntax  elements/  12—40 
basic  data  types,  12-40  to 
12-41 

common  command  elements,  12-42 
to  12-43 

program  control  elements,  12-46 
special  parser  elements,  12-43, 
12-45 

special  translator  elements, 
12-45  to  12-46 

/PRI  keyword  (VMR),  10-8,  10-25 
Primary  RBNs,  5-4 

Print  Despooler  Transaction  Block, 
17-30 

print  processors 
installation 

DCL  command,  7-6 
MCR  command,  7-6 
print  queue 

initialization 

DCL  command,  7-5 
MCR  command,  7-5 
/PRINTER  PORT  keyword  (VMR) , 

10-69" 

PRINTSUMMARY  command 
IOX,  4-49 

/PRIV  keyword  (VMR) ,  10-70 
Privileged  user  input 
rejection  of,  10-50 
PRO  attribute,  12-37 
/PRO  keyword  (VMR) ,  10-25 
PROCEED  command 
IOX,  4-50 

Processor  failures,  15-34 
Professional  Personal  Computer 
file  transfer,  9-1 
Prompting 

CLI,  11-7  to  11-8 
Protection 
file,  2-3 

Protection  mask,  10-25 
Protection  UIC,  10-25 
Prototype  task 
fixing,  10-18 


Prototype  tasks,  10-27 
PRT  error  messages,  A-2 
PRT  task,  1-6 
PRT • •  • 

See* Serial  Despooler  Task 
Pseudo  device 

installing  from,  10-3 
/PUB  keyword  (VMR) ,  10-70 

QMG,  1-2,  7-1 
commands,  7-14 

ASSIGN/QUEUE,  7-23 
DCL  format,  7-14 
DEASSIGN/QUE,  7-23 
DELETE,  7-21 
DELETE  PROCESSOR,  7-21 
DELETE/QUEUE,  7-21 
INITIALIZE/PROCESSOR,  7-16 
MCR  format,  7-14 
START,  7-27 
START/PROCESSOR,  7-29 
START/QUEUE,  7-27 
START/QUEUE/MANAGER,  7-27 
STOP,  7-24 
STOP/ABORT,  7-26 
STOP/PROCESSOR,  7-25 
STOP /QUEUE,  7-24 
STOP/QUEUE/MANAGER,  7-24 
INITIALIZE  command,  7-14 
INITIALIZE/QUEUE,  7-14 
installation,  7-3,  7-9 
starting,  7-4 

DCL  command,  7-4 
MCR  command,  7-4 
QMGCLI ,  7-1 
$QTRAN ,  17-17 
$QTRAN1,  17-18 
$QTRAN2,  17-19 
QUA  attribute,  12-38 
Queue  management  subsystem,  7-1 
to  7-2 

Queue  Manager,  1-2,  7-1 

RANDOM  command 
IOX,  4-51 
RANGE  command 
IOX,  4-52 
RBNs,  5-2 
primary 
secondary 

status  codes,  5-2  to  5-3 
RCT ,  5-1,  5-5 

See  Bad  Block  Replacement 
Control  Task 
and  Error  Logger,  5-5 
installation,  5-2 
RD:,  15-1 
REA 

See  REASSIGN  command  (VMR) 
Read 

nondestructive 

NFS  volumes,  4-64 
REASSIGN  command  (VMR) ,  10-38 
definition,  10-38 
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REASSIGN  command  ( VMR)  (Cont.) 
examples,  10-38 
format,  10-38 
parameters,  10-38 
Reconfiguration  components,  15-1 
CON,  15-1 
HRC ,  15-1 
RD:,  15-1 

Reconfiguration  driver 
See  RD: 

Reconfiguration  services,  1-4, 
15-1 

initiating,  15-4 
system  faults,  15-31 
Reconfiguration  task 
See  HRC 

RECORDS  command 
IOX,  4-53 

Recoverable  errors,  15-32 
RED 

See  REDIRECT  command  (VMR) 
REDIRECT  command  (VMR) ,  10-39 
definition,  10-39 
examples,  10-39 
format,  10-39 
parameters,  10-39 
restrictions ,  10-39 
/REG  keyword  (VMR),  10-19,  10-40, 
10-92 
Region 

disk  data  cache,  19-3 
extent,  19-3 
format,  19-4 
dynamic  storage,  10-69 
fixing,  10-19 
read-only,  10-26 
read/write  access,  10-26 
unfixing,  10-92 
/REGIS  keyword  (VMR) ,  10-70 
REM 

See  REMOVE  command  (VMR) 

/REMOTE  keyword  (VMR) ,  10-71  to 
10-72 

REMOVE  command  (VMR) ,  10-40 
definition,  10-40 
examples,  10-40 
format,  10-40 
keyword 

/REG,  10-40 
notes,  10-40 
parameters,  10-40 
Replacement  blocks 
See  RBNs 
Report 
interval 

output  frequency,  4-62 
REPORTERRORS  YES/NO  command 
IOX,  4-54 

Reschedule  interval,  10-43 
Resource  Accounting,  1-5,  17-1 
See  also  Transaction  file 
commands,  17-4 

SET  ACCOUNTING,  17-4,  17-8 


Resource  Accounting 
commands  (Cont.) 

SHOW  ACCOUNTING/DATATRIEVE , 

17-3,  17-17 

SHOW  ACCOUNTING/INFORMATION, 

17-3,  17-11 

SHOW  ACCOUNTING/TRANSACTION  FILE, 
17-3,  17-12 

START/ACCOUNTING,  17-4  to 
17-5 

STOP/ACCOUNTING,  17-4,  17-10 
device  statistics  example,  17-7 
interface  for  creating 
transactions 

$QTRAN ,  17-17 

$QTRAN1 ,  17-18 

$QTRAN  2 ,  17-19 
messages,  17-40 
privileged  task  interface, 

17-21 

scan  rate,  17-6 
secondary  pool,  17-5 
statistics  scan,  17-6 
system  resources,  17-39 
system  statistics,  17-5 
task  accounting,  17-6 
user-written  analysis  programs, 

17-3 

using  DATATRI EVE-1 1  for  an 
accounting  report,  17-16 
Resource  Monitoring  Display 
See  RMD 

RESTART  command 
IOX,  4-55 
RETRIES  command 
IOX,  4-56 

Revector  control  tables,  5-2 
RL02  exercise 
IOX,  4-10 
RMD,  1-2,  6-1 

Active  Task  Display,  6-8 
altering 

from  MCR ,  6-9 

altering  from  setup  page,  6-8 
Active  Task  List  Page,  6-1 
cache  region 

detailed  statistics 

altering  from  MCR,  6-18 
detailed  statistics  display, 

6-16 

altering  from  setup  page, 

6-17 

general  statistics 

altering  from  MCR,  6-16 
general  statistics  display, 

6-14 

altering  from  setup  page, 

6-15 

General  Statistics  Page,  6-1 
cached  device 

Detailed  Statistics  Page,  6-1 
display  pages,  6-1 
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RMD 

displaying 

disk  data  cache  statistics, 
19-14 

displaying  disk  data  cache 
statistics,  19-12 
displays  available  on 
RSX-11M-PLUS,  6-11 
error  messages,  6-18 
Help  display,  6-3 
Help  Page,  6-1 
I/O  Counts  Display 
altering 

from  MCR ,  6-12 
from  setup  page,  6-12 
I/O  Counts  Page,  6-1 
installation,  6-2 

MCR  INSTALL  command,  6-2 
RSX-11M  systems,  6-2 
RSX-11M-PLUS  systems,  6-2 
invoking,  6-2 
memory  display,  6-4 
FREE  command,  6-7 
modifying,  6-7 
RATE  command,  6-7 
Memory  Page,  6-1 
pages,  6-1 

running  on  a  slaved  terminal, 
6-3 

setup  command,  6-2 
setup  pages,  6-2 
System  Statistics  Display,  6-13 
altering 

from  MCR,  6-14 
from  setup  page,  6-14 
System  Statistics  Page,  6-1 
Task  Header  Display,  6-9 
altering 

from  MCR,  6-11 
from  setup  page,  6-10 
contents,  6-10 
Task  Header  Page,  6-1 
task-build  command  file 
altering,  6-18 
using  at  terminals,  6-2 
RMT ,  11-2 

/RNDC  keyword  (VMR) ,  10-72 
/RNDH  keyword  (VMR) ,  10-72 
/RNDL  keyword  (VMR) ,  10-72 
/RON  keyword  (VMR),  10-19,  10-26, 
10-92 

/ROPAR  keyword  (VMR) ,  10-26 
/RPA  keyword  (VMR) ,  10-73 
/RSI  keyword  (VMR) ,  10-44 
RSX11 . SYS 

See  Account  file 
RUN  command  (VMR) ,  10-42 
definition,  10-42 
formats,  10-42,  10-46 
keywords 

/RSI,  10-44 
/UIC,  10-44 
parameters,  10-42 
restriction,  10-42 


RUN  command  (VMR)  (Cont.) 

time  options,  10-42 
Running  VMR,  10-2 
RUNTIME  command 
IOX,  4-57 

SAB 

Resource  Accounting,  17-11 
Sample  configuration 

increasing  system  throughput, 
15-20 

SAV 

See  SAVE  command  (VMR) 

SAVE  command  (VMR) ,  10-47 
definition,  10-47 
example,  10-48 
format,  10-47 
keywords 

/BOOT,  10-47 
/DENS,  10-48 
notes,  10-48 
parameters,  10-47 
Scan  rate 

Resource  Accounting,  17-6 
/SEC  keyword  (VMR) ,  10-27 
Secondary  pool 

Resource  Accounting,  17-5 
Secondary  RBNs ,  5-4 
/SECPOL  keyword  (VMR) ,  10-73 
SELECT  command 
IOX,  4-58 

Serial  command  processing 
CLI,  11-8 
Serial  Despooler 
See  PRT 

Serial  Despooler  Task 
error  messages,  A-2 
receive  queue  operation,  A-l 
task-build  information,  A-l 
text  requirements,  A-l 
/SERIAL  keyword  (VMR),  10-73 
SET  /PLCTL  command,  13-12 
SET  ACCOUNTING 

Resource  Accounting,  17-4 
Set  Accounting  Transaction  Block, 
17-26 

SET  command,  15-27 

disk  data  caching,  19-16 
I/O  Queue  Optimization,  16-1 
SET  command  (VMR) ,  10-50 
definition,  10-50 
examples,  10-83,  10-87 
Executive  features,  10-50 
format,  10-50 

keyword  table,  10-51,  10-53 
keywords 

/AFF,  10-54 
/BOT,  10-55  to  10-56 
/BUF,  10-57 
/HFILL ,  10-59 
/LIBUIC,  10-60 
/LINES,  10-61 
/MAXEXT ,  10-63 
/NETUIC ,  10-63 
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SET  command  (VMR) 
keywords  (Cont.) 

/  [NO]ABAUD,  10-53 
/[NO]ANSI,  10-54 
/  [NO] AVO,  10-54 
/[NO]BLKMOD,  10-55 
/  [NO ] BRO ,  10-56 
/  [NO] CRT ,  10-57 
/ [NO ] DEC ,  10-57 
/ [NO] EBC ,  10-57 
/ [NO] ECHO,  10-58 
/  [NO] EDIT ,  10-58 
/  [NO ] ESCSEQ ,  10-58 
/ [NO] FDX,  10-59 
/ [NO] FORMFEED,  10-59 
/  [NO] HHT ,  10-59 
/  [NO ] HSYNC ,  10-60 
/  [NO] LOGON ,  10-61 
/ [NO ] LOWER ,  10-61 
/ [NO] MAIN,  10-61,  10-63 
/  [NO] OPT,  10-64 
/[NO]PAR,  10-64,  10-66 
/ [NO] PARITY ,  10-66  to  10-67 
/[NO] PASTHRU,  10-67 
/ [NO] PRINTER_PORT ,  10-69 
/[NOJPRIV,  10-70 
/ [NO] PUB ,  10-70 
/ [NO] REGIS ,  10-70 
/ [NO] REMOTE,  10-71  to  10-72 
/ [NO] RPA ,  10-73 
/ [NO]SERIAL,  10-73 
/ [NO] SLAVE ,  10-74 
/ [NO ] SOFT ,  10-74 
/ [NO] SUB ,  10-76  to  10-77 
/ [NO] TTSYNC ,  10-80 
/ [NO] TYPEAHEAD ,  10-80  to 
10-81 

/ [NO] VFI LL ,  10-81 
/ [NO] WCHK,  10-81 
/ [NO] WRAP ,  10-82  to  10-83 
/PLCTL,  10-68 
/POOL,  10-69 
/POOLSIZE,  10-69 
/RNDC,  10-72 
/RNDH,  10-72 
/RNDL ,  10-72 
/SECPOL ,  10-73 
/SPEED,  10-75 
/SWPC,  10-77 
/SWPR,  10-77 
/SYSUIC ,  10-77 
/TERM,  10-78  to  10-79 
/TOP,  10-79  to  10-80 
/UIC,  10-81 
parameter ,  10-51 
uses,  10-50 

SET  HOST/DTE  command,  9-3,  9-5  to 
9-6 

SET  PASSWORD,  2-1 

SET  TERMINAL  command,  9-3 

Shadow  Recording,  1-5 

Bad  block  handling,  18-10 
commands,  18-4 

ABORT,  18-4,  18-7 


Shadow  Recording 
commands  (Cont.) 

CONTINUE,  18-4,  18-8 
DISPLAY,  18-4,  18-9 
START,  18-4  to  18-5 
STOP,  18-4,  18-6 
controlling,  18-4 
error  messages,  18-11 
preparation,  18-2 
primary  disk  errors,  18-10 
secondary  disk  errors,  18-10 
simultaneous  disk  errors,  18-11 
uses,  18-1 
SHF,  1-4 
algorithms 

first  pass,  14-5 
second  pass,  14-6 
conventions,  14-1 
installation,  14-4 
monitoring  with  RMD,  14-4 
overhead,  14-4 
performance,  14-4 
removal,  14-5 
shuffling 

dynamic  common  regions,  14-5 
fixed  tasks,  14-5 
partition  sections,  14-5 
static  common  regions,  14-5 
size,  14-4 
$SHFCT 

changing  contents,  14-4 
$SHFTM ,  14-4 

SHOW  ACCOUNTING  commands,  17-11 
SHOW  ACCOUNTING/INFORMATION 
Resource  Accounting,  17-3 
SHOW  ACCOUNTING/TRANSACTION  FILE 
Resource  Accounting,  17-3- 
SHOW  CACHE  command 

disk  data  caching,  19-8 
SHOW  DEVICE  command 

disk  data  caching,  19-9 
Shuffler 
See  SHF 
Shutdown 

RSX-11M  system 
example,  8-5 
procedure,  8-4 
RSX-11M-PLUS  system 
example,  8-7 
procedure,  8-6 
SHUTUP 
examples 

RSX-11M,  8-2 
RSX-11M-PLUS ,  8-2 
input,  8-2 
invoking,  8-1 
output,  8-2 

prerequisites  to  running,  8-1 
SHUTUP  program,  1-3,  8-1 
SHUTUP.CMD,  8-3 

example  of  file,  8-4 
/SIZE  keyword  (VMR) ,  10-34 
/SL  switch  (TKB) ,  10-27 
/SLAVE  keyword  (VMR) ,  10-74 
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/SLV  (VMR) 

and  /SL  switch  (TKB) ,  10-27 
and  prototype  tasks,  10-27 
/SLV  keyword  (VMR)  ,  10-27 
Soft  errors,  15-32 
/SOFT  keyword  (VMR) ,  10-74 
Sort  option 
ACNT,  2-10 

/SPEED  keyword  (VMR) ,  10-75 
SPWN$  directive 
IOX 

in  EXECUTE  command,  4-37 
SPY  command 
IOX,  4-60 
START  command 
IOX,  4-61 

Shadow  Recording,  18-5 
START/ACCOUNTING 

Resource  Accounting,  17-5 
Starting  VMR,  10-2 
STARTUP.CMD ,  7-1 
Static  common  region 
checkpointing,  14-3 
resident  common,  14-3 
resident  libraries,  14-3 
shuffling,  14-6 
Statistics  scan 

Resource  Accounting,  17-6 
STOP  command 

Shadow  Recording,  18-6 
STOP/ACCOUNTING 

Resource  Accounting,  17-4 
/SUB  keyword  (VMR) ,  10-76  to 
10-77 

Summary  report 

generated  by  PRINTSUMMARY ,  4-49 
IOX,  4-20 

SUMMARYTIME  command 
IOX,  4-62 

SWITCH  command,  15-29 
/SWPC  keyword  (VMR) ,  10-77 
/SWPR  keyword  (VMR)  ,  10-77 
Symbol  Definition  File 
/IM  switch,  10-2 
relationship  to  system  image 
file,  10-1 
specifying,  10-2 
VMR  requirements,  10-1 
/SYNC  keyword  (VMR) ,  10-27 
Syntax  elements 

attributes,  12-26 
System  Account  Block,  17-3,  17-24 
System  device 
states,  15-2 

System  faults,  15-31,  15-33 
System  file  names 
conventions,  B-4 
System  File  Types,  B-5T  to  B-6T 
System  Image  File 

assigning  SY :  and  LB:,  10-1 

bootstrap,  10-1 
relationship  to  symbol 

definition  file,  10-1 
VMR  prompt,  10-3 


System  Image  File  (Cont.) 
creating,  10-18 
size,  10-18 

/SYSTEM  keyword  (VMR) ,  10-10 
System  reconfiguration,  15-1 
System  recovery,  15-33 
methods,  15-33 
System  statistics 

Resource  Accounting,  17-5 
System  Task  Directory,  10-31 
System  Time  Change  Transaction 
Block,  17-29 

System  UFDs,  B-3T  to  B-4T 
example,  B-3 

System-controlled  partition,  14-1 
conventions,  14-3 
definition,  14-3 
fragmentation 

causes  of,  14-4 
subpartitions  of,  14-3 
waiting  tasks,  14-3 
/SYSUIC  keyword  (VMR) ,  10-77 


Resource  Accounting,  17-11 
TAS 

See  TASKLIST  command  (VMR) 

Task 

access  to  commons,  10-25 
after  exit,  10-92 
checkpointable ,  10-18 

checkpointing,  10-22,  10-28 
execution  termination,  4-24 
extension  size,  10-24 
file  identification,  10-32 
fixed,  10-18 
initiation 
IOX 

EXECUTE  command,  4-37 
install  options,  10-29 
memory  management  support, 
10-18 

name 

CLI,  11-4 

reexecuting,  10-18 
removing,  10-18 

restrictions  for  fixing,  10-18 
size,  10-63 
system  size,  10-18 
unfixing  from  memory,  10-92 
with  external  headers,  10-28 
with  resident  headers,  10-28 
Task  Account  Block,  17-3,  17-22 
Task  accounting 

Resource  Accounting,  17-6 
Task  Control  Block,  10-31 
/TASK  keyword  (VMR) ,  10-27 
Task-build  file 

location  of  IOX,  4-22 
TASKLIST  command  (VMR) ,  10-88 
definition,  10-88 
examples,  10-88  to  10-89 
format,  10-88 
parameter,  10-88 
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Telephone 

dial  command  string,  9-4 
TEMPORARYFILE  command 
IOX,  4-63 

/TERM  keyword  (VMR) ,  10-78  to 
10-79 
Terminal 

baud  rate,  9-2 
emulation,  9-1,  9-5 
mute,  9-4 
nonslaved,  10-50 
port,  9-1 
slaved,  10-50 
typeahead,  9-5 
Terminal  emulation,  1-3 
establishing,  9-3 
terminating,  9-3 
Test  configuration 
IOX 

pattern  altering,  4-48 
pattern  displaying,  4-48 
setup,  4-6 

TIM 

See  TIME  command  (VMR) 

Time 

displaying,  10-90 
setting,  10-90 
TIME  command  (VMR) ,  10-90 
definition,  10-90 
examples,  10-90 
formats,  10-90 
notes,  10-91 
parameters,  10-90 
/TOP  keyword  (VMR) ,  10-79  to 
10-80 

Transaction  Account  Block,  17-3 
Transaction  file 

account  block  linkages,  17-38 
account  blocks,  17-11,  17-20 
system  account  block  (SAB) , 
17-11 

task  account  block  (TAB) , 
17-11 

transaction  account  blocks, 
17-11 

user  account  block  (UAB) , 
17-11 

accumulation  fields,  17-33 
block  diagrams,  17-22 
card  reader  job  data,  17-3 
card  reader  spooling  block, 
17-36 

crash  recovery  block,  17-35 
DATATRIEVE-11 ,  17-16 
device  allocation, 

deallocation,  or  dismount 
data,  17-2 

device  mount  data,  17-2 
device  statistics  block,  17-37 
device  usage  data,  17-3 
disk  accounting  block,  17-36 
example,  17-12 
header  area,  17-32 
invalid  login  block,  17-36 


Transaction  file  (Cont.) 
login  data,  17-2 
offset  definitions,  17-32 
print  despooler  block,  17-36 
print  job  data,  17-2 
set  accounting  block,  17-35 
size,  17-5 

system  account  block  (SAB) , 
17-35 

system  data,  17-2 
system  time  change,  17-3 
system  time  change  block,  17-36 
task  data,  17-1 
user  account  block,  17-33 
user  data,  17-1 
Transient  failures,  15-31 
Translator  processing,  12-19 
Transparent  spooling,  7-1 
TST  attribute,  12-39 
/TTSYNC  keyword  (VMR) ,  10-80 
Typeahead  buffer,  9-5 
/TYPEAHEAD  keyword  (VMR) ,  10-80 
to  10-81 

UAB 

Resource  Accounting,  17-11 
UFD,  B-l 

group  number,  B-l 

Accounting  tasks,  B-2 
DCL  files,  B-l 
Executive  files,  B-l 
FCP  files,  B-l 
FCS  files,  B-2 
K-Series  files,  B-2 
Line  printer  despooler,  B-2 
MCR  files,  B-l 
On-line  configuration,  B-2 
Privileged  utility  tasks,  B-l 
Queue  Manager  files,  B-2 
RMD  files,  B-l 
Shadow  Recording,  B-2 
SYSGEN  Indirect  command  files, 
B-2 

member  number ,  B-2 
Object  modules,  B-2 
SLP  correction  files,  B-2 
Source  modules,  B-2 
UFD  conventions,  1-6 
UFD  Group  Number  Identification 
Table,  B-lt  to  B-2t 
UFD  Member  Number  Identification 
Table,  B-2t  to  B-3t 
UIC,  10-25 

authorized,  2-1 

contained  in  account  entry,  2-1, 
2-7,  2-9 

displaying,  2-5,  2-8 
distinction  by  password,  2-1 
/UIC  keyword  (VMR),  10-28,  10-44, 
10-81 

UNF 

See  UNFIX  command  (VMR) 

UNFIX  command  (VMR) ,  10-92 
definition,  10-92 
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UNFIX  command  (VMR)  (Cont.) 
example,  10-92 
format,  10-92 
keywords 

/REG,  10-92 
/RON,  10-92 
parameters,  10-92 
UNL 

See  UNLOAD  command  (VMR) 

UNLINK  command,  15-30 
UNLOAD  command  (VMR) ,  10-93 
definition,  10-93 
example,  10-93 
format,  10-93 
keyword 

/VEC,  10-93 
parameter,  10-93 
restrictions ,  10-93 

User  Account  Block,  17-3,  17-23 
User  File  Directory 
See  UFD 

User  groups,  10-26 
User  Identification  Code 
See  UIC 

User-controlled  partition,  14-1 
User-written  encryption  routines 
support,  2-1 

VAX-11  RSX  file  transfer,  9-1, 
9-5 

VAX/VMS  file  transfer,  9-1,  9-5 
/VEC  keyword  (VMR),  10-34,  10-93 
VERIFY  command 
IOX,  4-64 

effect  on  NFS  volume,  4-8 
/VFILL  keyword  (VMR) ,  10-81 
Virtual  Monitor  Console  Routine 
See  VMR 

Virtual  Monitor  Console  Routine 
(VMR) 
see  VMR 
VMR,  1-3 

before  starting,  10-1 
command  abbreviations,  10-4 
command  description  format, 
10-7 

command  descriptions,  10-7, 
10-93 

command  format,  10-4 
command  keyword  values,  10-5 
command  keywords,  10-4 
command  names,  10-4 
command  parameters,  10-4 
command  syntax,  10-4 
command  types,  10-1 
comments,  10-5 
definition,  10-1 
error  messages,  10-94,  10-112 
exiting,  10-3 
file  specifications 
components,  10-5 
default  device,  10-5 
default  directory,  10-6 
default  file  name,  10-6 
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file  specifications  (Cont.) 
default  file  types,  10-6 
default  version  number,  10-6 
device  name,  10-5 
directory,  10-6 
file  names,  10-6 
file  type,  10-6 
format,  10-5 
/IM  switch,  10-7 
specifying,  10-5 
version  number,  10-6 
version  number  range,  10-6 
indirect  command  file,  10-3 
installing  from  LB:,  10-3 
introduction,  10-1 
prompt,  10-3 

relationship  to  MCR ,  10-1 
running,  10-2 

starting,  10-1  to  10-2,  10-4 
system  image  file 

assigning  SY :  and  LB:,  10-1 
bootstrap,  10-1 
relationship  to  symbol 

definition  file,  10-1 
VMR  commands 
ALTER,  10-8 
ASSIGN,  10-9 
CANCEL,  10-11 
CONFIGURATION,  10-12 
DEVICES,  10-16 
FIX,  10-18 
INSTALL,  10-21 
LOAD,  10-33 
LUNS,  10-35 
PARTITIONS,  10-36 
REASSIGN,  10-38 
REDIRECT,  10-39 
REMOVE,  10-40 
RUN,  10-42 
SAVE,  10-47 
SET,  10-50 
TASKLIST,  10-88 
TIME,  10-90 
UNFIX,  10-92 
UNLOAD,  10-93 
Volume 
Files-11 

protecting  with  TEMPORARYFILE , 
4-63 

NFS 

altering  block  range,  4-52 
displaying  block  range,  4-52 
error  retries,  4-56 
list  of  parameter  commands 
for,  4-9 
selecting 

with  IOX,  4-58 
with  VERIFY,  4-64 
selecting 

Files-11  for  IOX,  4-8 
NFS  for  IOX,  4-8 
VOLUMECHECK  command 
IOX,  4-65 
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WAIT  command 
IOX,  4-66 

/WB  keyword  (VMR) ,  10-28 
/WCHK  keyword  (VMR) ,  10-81 
/WRAP  keyword  (VMR) ,  10-82  to 
10-83 

Write-back  cache  data 
preventing  loss,  5-5 


Write-check 

enabling  in  IOX, 
WRITECHECK  command 
IOX,  4-67 


/XHR  keyword  (VMR) , 
XON/XOFF  protocol. 
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